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PREFACE 


MANUAL OBJECTIVES 


This manual is a guide to the use of RMS-11 in programs written in 
MACRO-11. It contains information necessary to writing MACRO-11 
programs and subprograms that use RMS-11 operations, 


INTENDED AUDIENCE 


This manual is intended for both the MACRO-11 programmer who wants to 
use RMS-11 operations and the high-level language PESO ramier who wants 
to use RMS-11 operations in a MACRO-11 subprogram. 


STRUCTURE OF THIS DOCUMENT 


e Chapter 1, Introduction to RMS-11 with MACRO-11, introduces 
RMS-11 macros and symbols that are the interface between a 
MACRO-11 program and RMS-11 operation routines. 


@e Chapter 2, RMS-1l Programming in MACRO-11, shows how to use 
RMS-11 macros and symbols in a MACRO-11 program. 


e Chapter 3, Processing Directories and Files, shows how to use 
directory and file operations to process directories and 
files, 


e Chapter 4, Processing Records and Blocks, shows how to use 
stream operations and either record or block operations to 
process records or blocks. 


@® Chapter 5, Operation Macro Descriptions, describes in detail 
each RMS~11 operation macro, the control blocks it uses, the 
options you can specify in each control block field, and the 
values returned in control block fields. 


@e Chapter 6, Control Block Fields, summarizes the use of each 
control block, field, value, and mask. 


@e Chapter 7, Example Programs, contains programs and program 


segments that illustrate the uses of some major RMS-11 
features. 
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Appendix A, Completion Codes and Fatal Error Codes, lists 
RMS-11 completion symbols, values, and meanings. 


Appendix B, Assembly-Time Messages, lists the messages that 
RMS-11 macros can generate at assembly time. 


® Appendix C, Macros That Declare Symbols and Other Macros, 
describes RMS-1l1 macros that declare other RMS-11 macros and 
define RMS-11 symbols. 


@ Appendix D, RMS-11 with Different Operating Systems, 
describes the differences among the behaviors of RMS-11 with 
various operating systems. 


@ The index includes a major entry for each RMS-11 macro, 
control block field mnemonic, keyword macro argument, and 
symbol family. 


ASSOCIATED DOCUMENTS 


RSX-11M/M-PLUS RMS-11: An Introduction introduces the major concepts 
of RMS-11, introduces the RMS-il operations, and defines key terms 
required for understanding RMS-11 capabilities and functions. You 
should read the introduction before proceeding to other manuals in the 
RMS-11 documentation set. 


The RSX-11M/M-PLUS RMS-11 User's Guide provides detailed information 
for both MACRO-11 and high-level language programmers on file and task 
design using RMS-1l. 


The RSX-11M/M-PLUS RMS-11 Utilities manual is both a user and a 
reference document for all users, both programmers and nonprogrammers. 
It describes the RMS-1l utilities that are available for creating and 
maintaining RMS-1l files. 


In addition, the RSX-11M/M-PLUS RMS-11 Mini-Reference Insert is an 
easy-reference guide for users who are familiar with RMS-11 and its 
documentation. It summarizes the RMS-11l utilities and error codes. 


CONVENTIONS USED IN THIS DOCUMENT 


The following conventions are used in statement formats in this 
document: 


UPPERCASE Uppercase characters within a string indicate 
characters that you must include in the string; you 
can type the characters in uppercase or lowercase. 


lowercase Lowercase characters within a string indicate a 
user-selected variable; text following the 
statement format defines the syntax of the variable. 


{ ] Square brackets indicate that the enclosed string is 
optional user input. 


ees A horizontal ellipsis indicates that the immediately 


preceding optional string (enclosed in square 
brackets) may be repeated. 
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In examples of commands you enter and system 
responses, all. output lines and prompting characters 
that the system prints or displays are shown in 
black letters. All the lines you type are shown in 
red letters, 


A nonalphabetic character (except a square bracket 
or a period that is part of an ellipsis) indicates a 
character that you must include in the string. 


Numbers in this manual that give the values of RMS-ll symbols are in 
octal radix (base 8) unless otherwise indicated; all other numbers in 
this manual are in decimal radix (base 10). 
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SUMMARY OF TECHNICAL CHANGES 


This revision contains the following technical changes: 


The new operation macros SENTER, SPARSE, S$REMOVE, SRENAME, 
and SSEARCH are documented, along with the related NAM block 
fields FNB, RSA, RSL, and RSS. 


The new facility for wildcard file specification is 
documented. 


The extension of access sharing is documented, along with the 
related masks FBSUPI and FBSNIL for the SHR field of the FAB. 


Random access to a sequential file with fixed-length records 
(similar to random access to a relative file) is documented. 


The new print-format record-output handling is documented, 
along with the related symbol FBSPRN for the RAT field of the 
FAB. 


The new sequential block access is documented; the previous 
block access (formerly called block I/0) is now called VBN 
access (virtual block number access). 


Block access can now be used to copy RMS-11 files without the 
need to modify the file's attributes manually. 


The addition of the success handler facility for file 
Operation macros (SCLOSE, SCREATE, SDISPLAY, SERASE, SEXTEND, 
and SOPEN) is documented. 


Increased device transparency for record access copy 
operations is supported. VFC and stream record formats are 
supported on unit-record devices. Relative and indexed files 
can be created for record access on nondisk devices, although 
they will appear as and be processed as sequential files 
there. 


The obsolete RMS-11 initialization macros SINIT and SINITIF 
are no longer documented. These macros are now defined as 
no-ops in the RMS-11 macro library RMSMAC.MLB; their 
previous functions are no longer needed because RMS-11 is now 
self-initializing. However, programs that use the SINIT and 
SINITIF macros in their previous senses remain valid under 
RMS-11 Version 2.0. 
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SUMMARY OF TECHNICAL CHANGES 


Each XAB type now has a distinct name; the following are the 
new names: 


ALL block Area allocation XAB 
DAT block File date XAB 

KEY block File key XAB 

PRO block File protection XAB 
SUM block File summary XAB 


The following symbol declaration macros are documented: 


FABSBT Declare FAB value and mask symbols 
NAMSBT _ Declare NAM block value and mask symbols 
RABSBT Declare RAB value and mask symbols 
XABSBT Declare XAB value and mask symbols 
XBAOFS Declare ALL block symbols 

XBDOFS$ Declare DAT block symbols 

XBKOFS Declare KEY block symbols 

XBPOFS Declare PRO block symbols 

XBSOFS Declare SUM block symbols 


The description of each operation macro includes the use and 
meaning of each associated control block field. 


The value of each RMS-11 user symbol is documented. 


The structure of each RMS-1l user control block is 
documented. 


The FAB has a new LRL (longest record length) field for 
sequential files (corresponding to the VAX-11 RMS XAB LRL 
field). 


The date/time XABs have changed in size from 36 to 46 octal 
bytes. ; 


For ANSI magtape, RMS-11 allows fixed-format records to be 
less than 18 bytes. 


<CTRL/Z> and <ESC> are no longer recognized as record 
terminators for stream files; and <CTRL/Z> is no longer 
recognized as a file terminator for stream files. 


RMS-11 now pads stream files with null characters to the high 
block of the file (not just to the end of the current block). 
This means that RMS-ll-created stream files can be read by 
programs that do not recognize the EOF value from the file 
header. 
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CHAPTER 1 


INTRODUCTION TO RMS~-11 WITH MACRO-11 


RMS-1l1 macros and symbols provide access to RMS-11 operations from a 
MACRO-11 program. 


1.1 ADVANTAGES OF USING RMS-11 MACROS 
When you use RMS-11 operations from a high-level language, the 
language restricts your options for some operations. If you cannot 


accept these restrictions, you can write your program (or some of its 
modules) in MACRO-11; this allows you full access to RMS-11 options. 


1.2 RMS-11 MACROS AND SYMBOLS 

RMS-1l1 macros and symbols define the interface between a MACRO-11 
program and RMS-1l operation routines. Definitions for these macros 
and symbols are in the RMS-11 macro library, RMSMAC.MLB. 

RMS-11 macros allow your program to: 


e Call RMS-11 operations 


e Declare and manipulate control blocks, through which your 
program communicates with RMS-11 operation routines 


e Declare and manipulate space pools 
e® Declare needed RMS-11 facilities 


e Extract (from the macro library RMSMAC.MLB) definitions for 
RMS-11 macros and symbols 


The following sections introduce RMS-11 macros and symbols. 
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1.2.1 Operations 


An RMS-11 operation macro calls a routine that performs an RMS-11 
operation, The name of an operation macro is the name of the 
corresponding operation, with a prefixed dollar sign (S$). The 
following are the RMS-11]1 operation macros: 


Directory File Stream Record Block 
Operation Operation Operation Operation Operation 
Macros Macros Macros Macros Macros 
SENTER SCLOSE SCONNECT SDELETE SREAD 
SPARSE SCREATE SDISCONNECT SFIND SSPACE 
SREMOVE SDISPLAY SFLUSH SGET SWRITE 
SRENAME SERASE SFREE SPUT 
SSEARCH SEXTEND SNXTVOL STRUNCATE 

SOPEN SREWIND SUPDATE 

SWAIT 


An RMS-11 operation returns a value called a completion code that 
indicates either a successful operation or an error. RMS-11 
completion symbols give names to these completion codes. 


When your program uses an RMS-11 operation macro to call an operation 
routine, it can specify completion handlers (one for a successful 
completion, one for an error completion) that RMS-ll calls when the 
operation completes. The RMS-11 completion-return macro (SRETURN) 
generates a proper return from a completion handler to the calling 
point in your program. 


1.2.2 Control Blocks and Fields 


Your program and RMS-11 operation routines communicate by passing data. 
in blocks called control blocks. Each control block is divided into 
fields; each field has a 3-letter mnemonic name. 


An RMS-11 block-declaration macro allocates space for a control block 
and- initializes fields containing the block length and block 
identifier. There is a block-declaration macro for each kind of 
control block. 


An RMS-11 field-initialization macro sets an initial value for a 
control block field at assembly time. There are field-initialization 
macros for most control block fields (those that you might reasonably 
want to initialize). 


An RMS-11 field-access macro manipulates the value of a control block 
field during program execution. There are field-access macros for 
copying values to and from fields (SSTORE and SFETCH), for comparing 
field values with other values (SCOMPARE), and for setting, clearing, 
and testing bits in fields (SSET, SOFF, and STESTBITS). 


RMS-11 code and mask symbols give names to the codes and bit masks 
used in many fields. This allows your program to determine the 
details of an RMS-11 operation without using the numeric values 
associated with those details. 


RMS-11 field-offset symbols give names to the locations of fields 
within their control blocks. Because RMS-11 field-initialization and 
field-access macros are based on field names, your program need not 
use field-offset symbols. 
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RMS-11 control blocks and their general uses are as follows: 


ALL (area allocation) block - contains information about a 
file area. i 


DAT (file date) block - contains file dates and the file 
revision number. 


e FAB (file access block) - contains general information about a 
file and how a program will access it. 


e KEY (file key) block - contains information about a file index 
and its key. 


e NAM (file name) block - contains special information about the 
device, directory, and specification for the file, along with 
wildcarding information. 


e@ PRO (file protection) block - contains file owner and 
protection information. 


e@ RAB (record access block) ~ contains general information about 
a stream and a record or block, and how the program accesses 
the record or block. 


e SUM (file summary) block - contains the number of areas and 
indexes in the file, and a version number indicating the 
internal structure level of the file. 


1.2.3 Pools 


RMS-11 conserves space by dynamically allocating and deallocating 
space set aside in pools. RMS-11 pool-declaration macros allocate 
space for pools. 


An RMS-11 routine called the get-space routine handles pooled space. 
You can substitute your own get-space routine for the RMS-11 routine; 
you can use RMS-11 get-space-address macros to initialize the address 
of the get-space routine at assembly time (GSAS), to change the 
address to that of a different routine during program execution 
($SETGSA), and to return the address of the current routine during 
program execution ($GETGSA). 


1.2.4 Facilities 


The RMS-1l1 facilities-declaration macro (ORG$) assists RMS-11 in 
determining exactly which routines your program needs during program 
execution. 


1.2.5 Macros That Declare Symbols and Other Macros 


To extract the definition of an RMS-1l macro from the macro library, 
your program must declare the macro in a .MCALL assembler directive. 


Many RMS-1l macros declare related macros and define related symbols; 
some RMS-ll macros have the sole purpose of declaring related macros 
and defining related symbols. Using these macros simplifies the job 
of declaring macros and defining symbols in your program. 


INTRODUCTION TO RMS-11 WITH MACRO-11 


For example, the FAB-declaration macro FABSB declares FAB 
field-initialization macros and FAB offset, code, and mask symbols; 
the $FBCAL macro declares all directory and file operation macros; 
the S$RMSTAT macro declares all completion symbols. 
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CHAPTER 2 


RMS-11 PROGRAMMING 


RMS-11 operations in a MACRO-11 program, your program must: 
Declare RMS-11 macros and symbols 


‘Before your program refers to an RMS-1l macro or symbol, it 
must extract its definition from the RMS-11 macro library. 
Section 2.1 shows how to declare macros and symbols. 


Declare RMS-11 facilities 


To help RMS-~11 decide which RMS-11 program modules are needed 
for your program, your program must declare some of the RMS-11 
operations that it uses. Section 2.2 shows how to declare 
RMS-11 facilities. 


Declare and use pool space 


RMS-11 dynamically allocates and deallocates space for some of 
its requirements; this space is separated into five pools. 
Using RMS-11 pool-declaration macros, you specify the size of 
each pool. Section 2.3 shows how to declare pool space. 


Declare and initialize control blocks 


Your program and RMS-11 operation. routines communicate by 
passing data back and forth in control block fields. Using 
RMS-11 block-declaration and field-initialization macros, your 
program allocates space for control blocks and (optionally) 
assigns initial values for fields. Section 2.4 shows how to 
declare and initialize control blocks. 


Use RMS-11 operations 


Your program uses RMS-11l operation routines to perform record 
management services; the routines return values that show the 
results of the operations. Your program uses RMS-11 operation 
macros to call these operation routines. Section 2.5 shows 
how to call RMS-11 operation routines and how to handle 
returns from the routines. 


Your program may also: 


Include completion handlers 


An RMS-11 operation routine returns either a .success 
completion code or an error completion code. Your program can 
include special routines (called success handlers and error 
handlers) that operation routines call automatically when 
operations complete. Section 2.6 shows how to write 
completion handlers. 
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Use its own get-space routines 


RMS-11 uses a routine (called a get-Space routine) to allocate 
and deallocate space. RMS-11 has a get-space routine, but you 
can also supply others of your own. Section 2.7 shows how to 
use get-space routines and how to write a get-space routine. 


Finally, you must: 
@ Assemble the program 


When you assemble your program, it needs macro and symbol 
definitions from RMS-11; these are in a macro library, which 
your assembler command line must reference. RMS-11 macros 
detect some kinds of errors during assembly, and print 
messages that identify the errors. Section 2.8 shows how to 
. assemble your program. , 


@ Build the task 
When you build your task, you must do one of the following: 
- Use an RMS-1l. resident library. 


- Define an overlay structure for the task. RMS-11 offers 
several overlay definition (ODL) files from which you can 
select; you can also write your own ODL files. 


- Include RMS-11 code in the task. 


2.1 DECLARING RMS-11 MACROS AND SYMBOLS 


Before your program refers to an RMS-11 macro or symbol, it must 
extract its definition from the RMS-11 macro library. : 


Your program can use the .MCALL assembler directive to extract the 
definition of any RMS-11 macro (but not a symbol) from the macro 
library. For example, to extract the definition of the macro S$CLOSE, 
use the .MCALL directive in the format: 


-MCALL SCLOSE ;Declare RMS-11 SCLOSE macro 


Your program can use RMS-11 macros to extract definitions for RMS-1ll1 
symbols, and for some groups of other RMS-11l macros. Appendix C lists 
RMS-11 macros (with their arguments) that declare symbols and other 
macros. 


2.2 DECLARING RMS-11 FACILITIES 


To help RMS-~11 decide which RMS-11l program modules your program needs, 
your program declares some of the operations that it uses. . To do 
this, it uses the facilities-declaration macro ORGS in the format: 


»=MCALL ORGS ;Declare ORGS macro 
ORGS fileorg[,<operation[,operation]...>] 


where fileorg is a keyword indicating a file organization and each 
operation is a keyword indicating an operation that your program uses 
for a file of that organization. 
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A separate ORGS macro is required for each different file organization 
that your program processes, except that no ORGS macro is required for 
an organization that will be processed using only directory operations 
and block access. 


The fileorg keyword argument to the ORGS macro is one of the 
following: 


IDX Indexed file organization 
REL Relative file organization 
SEQ Sequential file organization: 


Each operation argument to an ORGS macro is one of the following: Gv 


‘CRE CREATE operation a o> Ge it 
—~ DEL DELETE operation ; Hae oS 

FIN FIND operation - 

GET GET operation Tomer pee 

PUT PUT operation 

UPD UPDATE operation 


These are the only operations that your program explicitly declares 
with the ORGS macro;. . support for other operations is handled 
automatically. 
For example, suppose that your program: 

e Creates both sequential and indexed files 


@ Uses FIND, GET, PUT, and UPDATE operations for sequential 
files 


e Uses FIND, GET, PUT, and DELETE operations for indexed files 


Then the proper ORGS macros are: 


ORGS SEQ,<FIN,GET,PUT,UPD> ;Declare FIND, GET, PUT, and UPDATE 
s operations for sequential files 

ORGS IDX,<FIN,GET,PUT,DEL> ;Declare FIND, GET, PUT, and DELETE 
: operations for indexed files 


The results of ORGS macros are additive. For example, if one portion 
of your program specifies 


ORGS SEQ,<GET, PUT> 
and another specifies 
ORGS SEQ ,<GET,UPD> 
then the effect is the same as specifying 
ORGS SEQ,<GET,PUT,UPD> 
Note also that all ORGS macros must occur in modules that are 
contained in the root segment of your task (not overlaid). Use of 


ORGS macros is optional in tasks linked with an RMS-11 memory-resident 
library. 
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2.3 DECLARING AND USING POOL SPACE 


RMS-11 dynamically allocates and deallocates space for some of its 
requirements; this space is separated into five pools: 


Internal FAB and index descriptor block (IFAB/IDB) pool 

@e Internal RAB (IRAB) pool 

@ Key buffer pool 

e® I/0 buffer pool 

e Buffer descriptor block (BDB) pool 
RMS-11 has a get-space routine that manages these pools, and that 
allocates and deallocates space to meet the needs of RMS-11 
operations; however, you can supply other get-space routines and 
direct RMS-11 ‘to use a different routine (and, optionally, different 
pools) instead of its own. 
If you use only the RMS-11 get-space routine, declare pool space using 
the pool-declaration macros described below. If you use your own 
get-space routine, read Section 2.7; it shows how to write the 


routine, and how to manage the pools. 


To declare space for pools, use pool-declaration macros in the format: 


POOLSB 7;Begin pool declarations 

PSFAB fabcount ;Space for IFABs in IFAB/IDB pool 
PSIDX indexcount 7Space for IDBs in IFAB/IDB pool 
PSRAB rabcount 7Space for IRABs for sequential 


and relative files and for 

block-accessed indexed files 

in IRAB pool 

PSRABX rabxcount,keysize,keychanges ;Space for IRABs for 
record-accessed indexed 
files in IRAB pool, and 
space for key buffers in 
key buffer pool 

Space for I/O buffers in I/0 

buffer pool 
PSBDB bdbcount 7Space for BDBs in BDB pool 
POOLSE ;End pool declarations 


te Ne Ne 


PSBUF bufcount 


me Me Ne Ne Ne we 


If your program uses multiple pool declarations, the results are 
cumulative. 


The following sections show how to compute the values of arguments’ to 
the pool-declaration macros. 
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2.3.1 Internal FAB and Index Descriptor Block Pool 


Internal FABs (IFABs) and index descriptor blocks (IDBs) are the same 
size and so share a pool (the IFAB/IDB pool). The total size of the 
pool is the sum of the following: 


-@ The largest number of IFABs that your program uses at the same 
time, times 48 bytes. Specify this largest number of IFABs 
(not multiplied by 48) as the fabcount argument to the PSFAB 
macro. 


A directory operation uses one IFAB, which is returned to the 
pool before the operation completes. 


A CREATE or OPEN operation uses one IFAB, which is committed 
while the file is open; a CLOSE operation releases the IFAB. 
A DISPLAY or EXTEND operation uses no new IFABs; it uses’ the 
IFAB already committed to the open file. An ERASE operation 
uses one IFAB, which is released before the operation 
completes. 


@ The largest number of IDBs that your program uses at the same 
time, times 48 bytes. Specify this largest number of IDBs 
(not multiplied by 48) as the indexcount argument to the PSIDX 
macro. ; 


Your program uses one IDB for each index of each indexed file 
opened for record access (rather than block access). The IDBs 
for an indexed file are committed when the file is opened (by 
a CREATE or OPEN operation) and are released when the file is 
closed (by a CLOSE operation). 


2.3.2 Internal RAB Pool 


Internal record access blocks (IRABS) have a separate pool. The size 
of the IRAB pool is the largest number of streams that your program 
will have connected at the same time, times the size of an IRAB. (32 
bytes). 


Specify the largest number of streams connected to sequential files, 
relative files, and block-access indexed files (not multiplied by 32) 
as the rabcount argument to the PSRAB macro. Specify the largest 
number of streams connected to record-access indexed files as the 
rabxcount argument to the PSRABX macro. 


If the sum of the rabcount and rabxcount arguments is larger than the 
largest number of streams that will ever be connected simultaneously, 
you may deduct the excess from the rabcount argument that you specify. 


An IRAB is committed when a stream is connected and is released when 
the stream is disconnected or the file is closed (using the associated 
FAB). 
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2.3.3 Key Buffer Pool 


Key buffers have a separate pool. (These key buffers are different 
from those specified by the KBF and KSZ fields of the RAB.) 


Each time a stream is connected to an indexed file (for record 
access), the CONNECT operation requests space from the key buffer 
pool; the space is released when the stream is disconnected or the 
file is closed. 


Compute the size (in- bytes) of the request that the CONNECT operation 
makes as follows: 


1. Begin with the size of the largest key for the file. 
2. Multiply by 2. 


3. Add the number of alternate keys for the file that are 
allowed to change during updating. 


4. Addl. 
5. Round up (if necessary) to a multiple of 4. 


If your program performs complex sequences of CONNECT and DISCONNECT 
(or CLOSE) operations for record-access indexed files with different 
key sizes, the key buffer pool may become fragmented: (and therefore 
contain unusable’ space). In this case, the total size of the key 
buffer pool should be larger than the sum of the requirements for each 
connected stream. 


Each PS$RABX macro that your program uses (in the format PSRABX 
rabxcount,keysize,keychanges) allocates a number of bytes for the key 
buffer pool that is equal to 


(rabxcount) x ((keysize * 2) + keychanges + 1) 


The expression ((keysize * 2) + keychanges + 1) is rounded up (if 
necessary) to a multiple of 4. 


You can use PS$RABX macros to precisely tailor the size of the key 
buffer pool, or to provide extra space against possible fragmentation 
problems. A good compromise is to choose the arguments to the PSRABX 
macro as follows: 


@ Choose rabxcount as the largest number of streams that will be 
connected to record-access indexed files. 


e Choose keysize as the largest key in any file that will be 
processed. 


e Choose keychanges as the maximum number of changeable keys in 
any file that will be processed. 


2.3.4 I/0 Buffer Pool 


The 1/0 buffers for RMS-11 operations come either from the central 
buffer pool or from a private buffer pool. (These are RMS-11 internal 
I/O buffers, and are different from the I/O buffers specified in the 
RBF, RSZ, UBF, and USZ fields of the RAB.) 
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Your program can specify a private buffer pool for a directory or file 
operation (except CLOSE, DISPLAY, or EXTEND). If your program does 
not specify a private buffer pool, these operations use _ the central 
buffer pool. : 


All other operations that require 1/0 buffers use the same pool as the 
CREATE or OPEN operation that opened the file. 


The minimum size of the central I/O buffer pool is the sum of the 
sizes of the 1/0 buffers that your program will need from it at the 
same time (ignoring I/O buffers supplied from private buffer pools). 
Specify the size (in bytes) of the central buffer pool as the 
iopoolsize argument to the PSBUF macro. 


Specify the size (in bytes) of a private buffer pool for an operation 
in the 1-word BPS field of the FAB and the address in the 1l-word BPA 
field of the FAB. If your program specifies a private buffer pool for 
a. CREATE or OPEN. operation, the entire pool is reserved for and 
managed by that file until the file is closed. 


Your program needs space from buffer pools for the following: 


e One 512-byte I/O buffer for any directory or file operation 
(except CLOSE, DISPLAY, or EXTEND). This space is released 
before the operation completes. 


@ One 512-byte I/O buffer for a DISPLAY or EXTEND operation for 
-a. record-access. relative or indexed file; the space is 
returned when the operation completes. 


e® 1/0 buffers for a CONNECT operation: 


- One I/O buffer for a record-access stream connected to a 
sequential disk file. The I/O buffer uses 512 bytes times 
the multiblock count for the stream. 


-~ One I/O buffer for a record-access stream connected to a 
sequential magtape file. The number of bytes in the I/0 
buffer is the block size for the file, rounded up (if 
necessary) to a multiple of 4 bytes. 


- One I/O buffer for a record-access stream connected to a 
file on a unit-record device. The number of bytes in the 
I/O buffer is equal to the default block size for the 
device, rounded up (if necessary) to a multiple of 4 bytes. 


- One or more I/0 buffers for a stream connected to a 
relative file. Each 1/0 buffer uses 512 bytes times the 
bucket size for the file. If you use the multibuffer count 
to specify additional buffers, the requirement increases 
accordingly. 


- Two or more I/O buffers for a stream connected to an 
indexed file. Each I/0 buffer uses 512 bytes times the 
bucket size for the file. If you use the multibuffer count 
to specify additional buffers, the requirement increases 
accordingly. 


I/O buffers for a connected stream are retained until the 
stream is disconnected by a DISCONNECT or CLOSE operation. 
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If your program uses the I/O buffer pool for complex sequences of 
operations that use I/0 buffers for different files, the pool may 
become fragmented. In that case, you may want to either allocate 
extra space in the I/O buffer pool, or limit fragmentation through the 
judicious use of private buffer pools. 


2.3.5 Buffer Descriptor Block Pool 


Your program requires one 20-byte buffer descriptor block (BDB) for 
each I/0 buffer (whether from the central or a private pool) that it 
uses at the same time; these BDBs are allocated and returned at the 
same time as their associated 1/0 buffers. (I/0 buffer requirements 
are described in the previous section.) 


In addition, a block-access stream (for any file) or a record-access 
stream that will write to a relative file requires an additional BDB; 
a record-access stream that will write to an indexed file requires two 
additional BDBs. These BDBs are returned when ‘the stream is 
disconnected (or the file is. closed). 


An EXTEND operation for a record-access relative or indexed file also 
requires an additional BDB, which is. returned when the operation 
completes. 


Therefore the size of the BDB pool is the largest number of BDBs 
required at any one time, times 20 bytes. Specify this largest number 


of BDBs (not multiplied by 20) as the bdbcount argument to the PSBDB 
macro. 


2.4 DECLARING AND INITIALIZING CONTROL BLOCKS 

Your program and RMS~11 operation routines communicate by passing data 
back and forth in control block fields. Using RMS-11 
block-declaration and field-initialization macros, you allocate space 
for control blocks and (optionally) assign initial values for fields. 


To declare a control block and initialize its fields, use 
block-declaration and field-initialization macros as follows: 


1. Make sure the control block is word-aligned by using the 
-EVEN directive: 


- EVEN ;Word-align block 


2. Specify a label so that your program can refer symbolically 
to the address of the control block. 


label: 


3. Begin the block declaration with one of the following macros: 


FABSB ;Begin FAB declaration 
NAMSB ;Begin NAM block declaration 
RABSB SYN ;Begin RAB declaration for 

7 synchronous RAB 
RABSB ASYN ;Begin RAB declaration for 

7 asynchronous RAB 
XABSB XBSALL ;Begin ALL block declaration 
XABSB XBSDAT ;Begin DAT block declaration 
XABSB XBSKEY ;Begin KEY block declaration 
XABSB XBSPRO 7Begin PRO block declaration 
XABSB XBSSUM ;Begin SUM block declaration 
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4. Initialize (optionally) fields with |. field-initialization 
macros of one of the forms: 


FSfld arg sInitialize FAB field ; 
NSf£ld arg sInitialize NAM block field 
RSfl1d arg ;Initialize RAB field 

XSf1d arg ;Initialize XAB field 


In each of these forms, fld is the mnemonic for a field in 
the control block; arg is an argument suitable for the value 
of the field. Chapter 6 describes field-initialization 
macros and their arguments. 


5. End the block declaration with one of the following macros: 


FABSE ;End FAB declaration 
NAMSE ;End NAM block declaration 
RABSE ;End RAB declaration 


XABSE :End XAB declaration 


2.5 USING RMS-11 OPERATIONS 


Your program uses RMS-11 operation routines to perform record 
management services. Using RMS-11 operation macros, you call these 
operation routines. The routines return values in control block 
fields that show the results of the operations. 


To use RMS-1l operation routines, your program must: 
e Set up control block fields 


The values that your program places in control block fields 
specify the details of the service you want from the RMS-11 
operation routine. Section 2.5.1 shows how to set up control 
block fields. 


e Chain control blocks 


Some RMS-11 operation routines (stream, record, and block 
operation routines) read only RAB fields; others (directory 
and file operation routines) read FAB fields and, if your 
program supplies them, fields in NAM blocks and XABs. Your 
program chains these blocks (using address pointers) so that 
the operation routine can find them. Section 2.5.2 shows how 
to chain control blocks. 


e Call operation routines 


You use RMS-1l operation macros to call RMS-11 operation 
routines. Section 2.5.3 shows how to call operation routines. 


e@ Handle returns 


Section 2.5.4 shows how to handle returns from operation 
routines. 


' Examine returned values 


When an RMS-11 operation routine completes its execution, it 
has placed values in control block fields that show the 
results of the operation. Your program should examine these 
values to determine the results. Section 2.5.5 shows how to 
examine returned values. 
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2.5.1 Setting Up Control Block Fields 


The values that your program places into control block fields specify 
the details of the service you want from the RMS-11 operation routine. 
The description of each operation macro in Chapter 5 discusses the 
control block fields that are read by that operation. 


Three RMS-11 field-access macros help you place values into control 
block fields: 


@ SSTORE places a specified value into a field. 
e SSET sets bits in a field. 


e SOFF clears bits in a field. 


2.5.1.1 SSTORE Macro - Use the SSTORE macro to copy a value from a 
specified location to a control block field. The format for the 
SSTORE macro is: 


SSTORE src,fld,reg 


where sre is a an address in memory; fld is a field mnemonic; and 
reg is a general purpose register (RO through R5) containing the 
address of the control block. 


The SSTORE macro looks up the size of the destination field, so that 
it can copy the correct number of bytes or words. If the source is a 
register and the destination is a l-byte field, then the low byte of 
the register is copied; if the source is a register and the 
destination is a multiword field, then the contents of the specified 
register and following registers are copied. 


The SSTORE macro generates an error during assembly if you use an 
illegal address mode for the source. For mulitiword fields, illegal 
address modes are autoincrement deferred, autodecrement deferred, and 
indexed deferred. 


It is also illegal to specify the program counter (PC) as the source 
or to specify a register as source in such a way that the source 
overlaps the register that contains the control block address. 


At execution time, the S$STORE macro .copies the contents of the 
specified location to the control block field. The number of bytes or 
words copied is the same as the field size for the mnemonic. Chapter 
6 gives the size of each control block field. 


For example, suppose that you want to specify indexed file 
organization in the FAB for a file, and suppose that the address of 
that FAB is stored in register R2. Then the proper macro is: 

SSTORE #FBSIDX,ORG,R2 ;Indexed file organization 


Suppose that you want to chain a NAM block whose label is NAMBLK to 
the same FAB. Then the proper macro is: 


SSTORE  #NAMBLK,NAM,R2 ;Chain NAM block 
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Suppose that you want to set the allocation quantity (ALQ field) of 
the same FAB to the value stored in a location labeled ALQVAL. Then 
the proper macro is: 


SSTORE ALQVAL ,ALQ,R2 ;Load allocation quantity 


and (because ALQ is a 2-word field) two words are copied from ALQVAL 
to the ALQ field. 


2.5.1.2 SSET Macro - Use the SSET macro to set bits in a 1~byte or 
l-word control block field. The S$SET macro logically ORs a given mask 
into the control block field. Therefore for each bit set in the mask, 
the SSET macro sets the corresponding bit in the field; the other 
bits are not changed. 


Note that you use the SSET macro only if you want to leave some bits 
in a field undisturbed; if you want to set specified bits and clear 
all others, use the SSTORE macro. 


The format for the SSET macro is: 
SSET mask,fld,reg 


where mask is an address in memory containing bits to be set; f1d is 
the mnemonic for a control block field; and reg is a general purpose 
register (RO through R5) containing the address of the control block. 


If the field is not a l-byte or l-word field, the SSET macro generates 
an error during assembly. 


RMS-11 has symbols for masks for each bit-oriented control block 
field. Therefore your program can use these symbols instead of 
numerical values. 


For example, suppose you want to specify rewind-on-close in the FAB 
for a file, but do not want to disturb other bits in the FOP field of 
the FAB; suppose also that the address of the FAB is in register R2. 
Then the proper macro is: 


SSET #FBSRWC,FOP,R2 ;Rewind-on-close 


As another example, suppose you want to specify key-duplicates-—allowed 
and key-changes-allowed for an index, but do not want to disturb other 
bits in the FLG field of the KEY block; suppose also that the address 
of the KEY block is in register R4. Then the proper macro is: 


SSET #XBSDUP! XBSCHG,FLG,R4 ;Allow key duplicates and changes 


2.5.1.3 S$OFF Macro — Use the SOFF macro to clear bits in a 1l-byte or 
l-word control block field. The SOFF macro logically ANDs the l's 
complement of a given mask into the control block field. Therefore 
for each bit set in the mask, it clears the corresponding bit in the 
field; the other bits are not changed. 


Note that you use the SOFF macro only if you want to leave some bits 
in a field undisturbed; if you want to clear the entire field, use 
the SSTORE macro (with a source value of #0). 
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The format for the SOFF macro is: 
SOFF mask,f1d,reg 


where mask is an address in memory containing bits to be cleared; f1ld 
is the mnemonic for a control block field; and reg is a general 
purpose register (RO through R5) containing the address of the control. 
block. 


If the field is not a 1l-byte or l-word field, the SOFF macro generates 
an error during assembly. 


RMS-11 has symbols for masks for each bit-oriented control block. 
field. Therefore your program can use these symbols instead of 
numerical values. 


For example, suppose you want to specify no-rewind~on-close in the FAB 
for a file, but do not want to disturb other bits in the FOP field of 
the FAB; suppose also that the address of the FAB is in register R2. 
Then the proper macro is: 


SOFF #FBSRWC,FOP,R2 ;No rewind-on-close 


As another example, suppose you want to specify 
no-key-duplicates-allowed and no-key-changes-allowed for an index, but 
do not want to disturb other bits in the FLG field of the KEY block; 
Suppose also that the address of the KEY block is in register R4. 
Then the proper macro is: 


SOFF #XBSDUP!XBSCHG,FLG,R4 ;No key duplicates or changes 


2.5.2 Chaining Control Blocks 


An RMS-11 directory operation or file operation uses at least one FAB; 
you specify FABs in the operation macros that call the operation 
routines. ep fog 


For some directory operations, a NAM block is required; it is 
optional for other directory operations and for file operations. You 
specify a NAM block and XABs for an operation by chaining them to the 
FAB for the operation. 


2.5.2.1 Chaining a NAM Block to a FAB - Specify the NAM block 
associated with a FAB by placing its address in the l-word NAM field 
of the FAB. 


2.5.2.2 Chaining XABs to a FAB — Specify the XABs associated with a 
FAB by placing the address of the first XAB in the l-word XAB field of 
the FAB; in each XAB, specify the address of the next XAB in the 
chain in the 1-word NXT field of the XAB; in the last XAB in the 
chain, specify 0 in the NxT field. 


Follow these rules in ordering XABs in a chain: 


Place ALL blocks together in the chain. Each ALL block is 
"numbered" by the value in the l-byte AID field of the ALL 
block; chain ALL blocks so that these numbers’ are in 
ascending order. For the CREATE operation, begin with 0 and 
do not skip numbers in the ascending sequence; for other 
operations, you can skip numbers in the sequence. 
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Place no more than one DAT block in the chain. 


Place KEY blocks together in the chain. Each KEY block is 
"numbered" by the value in the l-byte REF field of the KEY 


block; chain KEY blocks so that these numbers are in 
ascending order. For the CREATE operation, begin with 0 and 
do not skip numbers in the ascending sequence; for other 


operations, you can skip numbers in the sequence. 
e Place no more than one PRO block in the chain. 


@ Place no more than one SUM block in the chain. 


2.5.2.3 Chaining a FAB to a RAB (CONNECT Operation) - The CONNECT 
operation creates a stream for a file. A FAB specifies the file; a 
RAB specifies the stream. Specify the address of the FAB for the file 
in the l-word FAB field of the RAB for the stream. 


2.5.3 Calling Operation Routines 


Use RMS-1l operation macros to call operation routines. You can 
specify arguments for the operation routine either by giving them as 
arguments to the operation macro, or by placing them in an argument 
block in memory. 


2.5.3.1 Call with Macro Arguments - Call an operation routine (except 
RENAME) using an operation macro with arguments in the format: 


Smacroname blkaddr[,[erraddr][,sucaddr] ] 
where S$macroname is the name of an operation macro (except S$RENAME); 
blkaddr is the address of a FAB (for a directory or file operation) or 
a RAB (for a stream, record, or block operation); erraddr is the 
address of an error handler for the operation; and sucaddr is the 
address of a success handler for the operation. 
For example, if you want to open a file using a FAB at address INFAB 
and want to use a success handler at address SUCCES, the macro call 
would be: 

SOPEN #INFAB,,#SUCCES 


Call the RENAME operation using the SRENAME operation macro with 
arguments in the format: 


SRENAME oldfabaddr,[erraddr] ,[sucaddr]} ,newfabaddr 


where oldfabaddr is the address of a FAB for. the old file 


specification; erraddr is the address of an error handler for the 
operation; sucaddr is the address of a success handler for the 
operation; and newfabaddr is the address of a FAB for the new file 


specification. 
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2.5.3.2 Call with Arguments in Memory - To call an operation routine 
using an operation macro with arguments in an argument block in 
memory, omit the arguments to the macro, store the address of the 
argument block in register R5, and store the argument block in memory 
as follows: 


[rca 


ZK-1097-82 


The argument count is 4 for a RENAME operation; otherwise it is one 
of the following: 


@e 1 - no completion handlers 
e 2 - error handler, but no success handler 
@e 3 - success handler 


If the operation has no error handler, but either has a success 
handler or the operation is RENAME, specify -1 as the address of the 
error handler; if the operation has no success handler, but the 
operation is RENAME, specify -1l as the address of the success handler. 


2.5.4 Handling Returns 


An RMS—-11 file or directory operation returns a completion status code 
in the l-word STS field of the FAB and, for some completions, a 
completion status value in the l-word STV field of the FAB. 


An RMS-11 stream, record, or block operation returns a completion 
status code in the l-word STS field of the RAB and, for some 
completions, a completion status value in the l-word STV field of the 
RAB. 


Appendix A lists completion codes. 


Your program should examine the STS field contents to determine 
whether the operation was successful; even if the operation returned 
an error completion, your program may be able to handle the error and 
recover. 


The program can handle the return (based on the completion code) 
either in the code that immediately follows the operation macro, or in 
special routines (called completion handlers) that the operation can 
call. Section 2.6 shows how to write completion handlers. 
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There are two kinds of fatal RMS-11 errors: 


If the FAB or RAB address you specify is not the address of a 
valid and idle FAB or RAB, or if the argument block you 
provide is invalid, RMS-11 cannot return values, even in the 
STS field. RMS-11 issues a BPT instruction, leaving status 
information in the following registers: 


RO: RMS-11 fatal error code 

Rl: Stack pointer (at time of entry to RMS-11 routine) 
R2: Program counter (entry return same as @R1) 

R3: Address of system impure area 


@e If RMS-11 detects the corruption of memory-resident data 
structures, or if it detects inconsistent internal states, it 
cannot proceed with its operations. In these cases, RMS-I11 
haits execution with a BPT instruction; if it can identify 
the error, RMS-11 leaves an error completion in RO. 


Appendix A lists the symbols and values for RMS-1l fatal error codes. 


2.5.5 Examining Returned Values 


When an RMS-11 operation routine completes its execution, it has 
placed values in control block fields that show the results of the 
operation. Your program should examine these values to determine the 
results. The description of each operation macro in Chapter 6 
discusses the control block fields that return values for that 
operation. 


Three RMS-11 field-access macros help you examine values in control 
block fields: 


e SFETCH copies a value from a field to a specified location. 
@ SCOMPARE compares a field value to a specified value. 


e STESTBITS determines whether specified bits in a field are 
set. 


2.5.5.1 S$FETCH Macro - Use the SFETCH macro to copy a_ value ‘from a 
control block field to a specified location. The format for the 
SFETCH macro is: 


SFETCH dst,fld,reg 


where dst is an address in memory; £1d is the mnemonic for a_ control 
block field; and reg is a general purpose register (RO through R5) 
containing the address of the control block. 


The S$FETCH macro looks up the size of the source field, so that it can 
copy the correct number of bytes or words. If the destination is a 
register and the source is a l-byte field, then the byte is copied to 
the low byte of the register and the high byte is cleared. if the 
destination is a register and the source is a multiword field, then 
the multiword field is copied to the specified register and following 
registers. 
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The SFETCH macro generates an error during assembly if you use an 
illegal address mode for the destination. For multiword fields, 
illegal address modes are autoincrement deferred, autodecrement 
deferred, and indexed deferred. Immediate mode is illegal for $FETCH, 
regardless of field size. 


It is also illegal to use the program counter (PC) as the destination 
or to specify a register for the destination in such a way that the 
destination overlaps the register that contains the control block 
address. 


At execution time, the SFETCH macro copies the contents of the control 
block field to the specified location. The number of bytes or words 
copied is the same as the field size for the mnemonic. Chapter 6 
gives the size of each control block field. 


As an example of the use of the $FETCH macro, suppose that you want to 
fetch the allocation quantity (ALQ field) from a FAB to a location 
labeled ALQSAV, and suppose also that the address of the FAB is in 
register R3. Then the proper macro is: 

SFETCH ALQSAV,ALQ,R3 ;Save allocation quantity 


and two words are copied from the ALQ field to memory beginning at 
ALQSAV. 


2.5.5.2 SCOMPARE Macro - Use the SCOMPARE macro to compare the 
contents of a 1-byte or l-word control block field with a specified 
value. The format for the SCOMPARE macro is: 

SCOMPARE src,fld,reg 
where sre is an address in memory; f£1d is the mnemonic for a control 
block field; and reg is a general purpose register (RO through R5) 
containing the address of the control block. 


If the given field is not a l-byte or l-word field, the $COMPARE macro 
generates an error during assembly. 


At execution time, the SCOMPARE macro executes a machine instruction 
that compares the source value and the field contents. The 
instruction executed depends on the size of the specified field and on 
the specified source: 

e TSTB for a l-byte field and the source #0 

e TST for a 1l-word field and the source #0 

e cCMPB for a l-byte field and a source other than #0 

e CMP for a l-word field and a source other than #0 
Chapter 6 gives the size of each control block field. 
For example, suppose that you want to compare the value in the RSZ 
field of a RAB with a value stored in a location labeled RSZSAV, and 
suppose also that the address of the RAB is stored in register R2. 
Then the proper macro is: 


SCOMPARE RSZSAV,RSZ,R2 ;Compare record size 
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- Suppose that you want to compare the same RSZ field to the value of a 
symbol, RECSIZ. Then the proper macro is: 


SCOMPARE #RECSIZ,RSZ,R2 :Compare record size 


2.5.5.3 S$TESTBITS Macro - Use the STESTBITS macro to test the values 
of bits in a l-byte or l-word control block field. Chapter 6 gives 
the size of each control block field. The format for the S$TESTBITS 
macro is: 


STESTBITS mask,fld,reg 


where mask is an address in memory containing bits to be tested; fla 
is the mnemonic for a control block field; and reg is a general 
purpose register (RO through R5) containing the address of the control 
block. 


If the given field is not a l-byte or 1-word field, the S$TESTBITS 
macro generates an error during assembly. 


At execution time, the STESTBITS macro executes a machine instruction 
that tests the bits specified in the mask. The instruction executed 
depends on the size of the specified field: 


e BITB for a l-byte field 
e BIT for a l-word field 


For example, suppose you want to determine whether the terminal device 
is set in the DEV field of a FAB, and suppose that the address of the 
FAB is in register R3 Then the proper macro is: 


STESTBITS #FBSTRM,DEV,R3 ;Terminal device? 


As another example, suppose that you want to determine whether either 
the contiguous-area or the hard-location bit is set in the AOP field 
of an ALL block, and suppose that the address of the ALL block is in 
register R2. Then the proper macro is: 


STESTBITS #XBSCTG!XBSHRD,AOP,R2 ;Contiguous or hard location? 


2.6 WRITING COMPLETION HANDLERS 


Recall that when you use an RMS-11 operation macro, you can specify 
the addresses of completion handlers for the operation; if you do so, 
the operation automatically calls the error handler (for a nonfatal 
error completion) or the success handler (for a success completion) 
when the operation completes, before control returns to your program. 


When execution control passes to your completion handler, it finds the 
following situation: 


e Register R5 contains the address of the argument block for the 
operation. 


If the operation is asynchronous, the address is the address 
of a copy of the original argument block for the operation. 


The second word of the argument block contains the address of 
the FAB or RAB for the operation. (Recall that the STS and 
STV fields of the FAB or RAB contain the completion code and 
completion value for the operation.) 
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If the operation was RENAME, the fifth word of the argument 
block contains the address of a second FAB for the operation. 


Other blocks are chained as they were when you used _ the 
operation macro that called the operation routine. 


A completion handler cannot determine from these values which RMS-11 
operation was executed, or. what part of your program called the 
operation routine. You can, however, use the l-word CTX field of the 
FAB or the 1-word CTX field of the RAB to indicate the context of the 
operation; RMS-11 does not disturb values in CTX fields. 


The completion handler must preserve the stack pointer (SP), and must 
end with the RMS-11 completion-return macro in the format: 


SRETURN End of completion handler 


2.7 USING GET-SPACE ROUTINES 


Your program can provide and use get-space routines other than the one 
provided with RMS-11. It can set an initial get-space routine at 
assembly time, and it can change to other routines during program 
execution. Section 2.7.1 shows how to specify get-space routines, and 
how to obtain the address of the current get-space routine. Section 
2.7.2 shows how to write a get-space routine. 


2.7.1 Specifying Get-Space Routines 


To specify a get-space routine at assembly time, use the GSAS macro in 
the format: 


GSAS address ;Initialize get-space routine 
; address 


where address is the get-space routine entry address. If you specify 
0 as the address, or if you do not use the GSAS macro, the initial 
get-space routine for the program is the RMS-11 routine. 


For example, to specify a routine that begins at the label MYSPAC, you 
would use: 


GSAS MYSPAC 


To change the get-space routine during program execution, use the 
SSETGSA macro in the format: 


SSETGSA pointer ;Change get-space routine 
where pointer is the address of a location that contains the get-space 
routine entry address. If you specify the entry-point address as 0, 


the new get-space routine established is the RMS-11 routine. 


For example, to specify a routine that begins at the label NEWSPC, you 
could use: 


SSETGSA #NEWSPC 


Alternatively, if the location GSATMP contains the value NEWSPC, you 
could use: 


SSETGSA GSATMP 
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To obtain the address (in RO) of the current get-space routine during 
program execution, use the SGETGSA macro in the format: 


SGETGSA ;Get-space routine address into RO 


If the address returned in RO is 0, the current get-space routine is 
‘the RMS-11 routine. 


2.7.2 Writing a Get-Space Routine 


A get-space routine handles space in contiguous blocks. For a request 
for space, it allocates a contiguous block of space (or denies the 
request); for a release of space, it accepts a contiguous block of 
space. 


A get-space routine must have a proper interface to calling routines, 
and it should handle unallocated space properly. 


2.7.2.1 Get-Space Routine Interface - When RMS-1l calls a get-space 
routine, it either requests or releases a block of space. Fora 
request for space, registers RO through R2 contain the following 
values: 


RO Address of pool free-space list (see next section) 
R1 Size (in bytes) of requested block 
R2 0 


If the get-space routine fills the request, it must clear the C bit 
and return the address of the first word of the allocated block in RO; 
if it does not fill the request, it must set the C bit. In either 
case, the routine must preserve the stack and registers R3 through R6. 


For a release of a block of space, registers RO through R2 contain the 
following values: 


RO Address of pool free-space list (see next section) 
RL Size (in bytes) of released block 
R2 Address of first word being released 


For a release-space operation, the get-space routine returns no 
values; however, it must preserve the stack and registers R3 through 
R6. 


2.7.2.2 Pool Free-Space Lists - When RMS-11 calls your get-space 
routine, the address of a pool free-space list is in register RO. 
This free-space list specifies free space in one of the five pools 
described in Section 2.3; you can use this pool (which may or may not 
have adequate free space), or you can use a pool of your own. 


The free-space list chains free contiguous blocks of the pool. The 
first word of each block contains the address of the next block; if 
the first word of a block is 0, it is the last block in the list. 


Blocks in the list are ordered by ascending virtual addresses; their 
addresses are word-aligned; their sizes are multiples of 4 bytes 
{allocations and deallocations must be rounded up to a multiple of 4, 
if necessary). 
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The second word of each block contains the size (in bytes) of the 
block, including the 4-byte header; the first "block" in the list 
contains 0 in its second word, since it is the header block for the 
list. 


Your get-space routine can use the specified pool list to get space 
for RMS-ll; if it does this, it must properly maintain the list, and 
must (if possible) merge blocks back into the pool. 


The system routines $RQCB and $RLCB are suitable for handling pool 
free-space lists. These routines have interfaces that meet the 
requirements for your get-space routine; therefore your program can 
jump to SRQCB (for a space request) or SRLCB (for a space release). 


2.8 ASSEMBLING THE PROGRAM 


When you assemble your program, you must cause the assembler to get 
RMS-1l macro and symbol definitions from a library, and you may have 
to correct errors indicated by messages from RMS-11 macros. 


2.8.1 Assembling with the RMSMAC Macro Library 


When you assemble your program, the assembler needs definitions for 
the RMS-1l1 macros and symbols that your program uses; these are in 
the RMS-11 macro library, RMSMAC.MLB. Include the following reference 
to the RMS-11 macro library in your assembler command string: 


LB: {1,1] RMSMAC.MLB/ML 


2.8.2 Assembly-Time Errors from RMS-11 Macros 


RMS-11 macros detect some errors during assembly. For each such 
error, a macro issues a .PRINT or .ERROR assembler directive with a 
message. Appendix B describes RMS-11 macro-generated messages and 
their meanings. 


CHAPTER 3 


PROCESSING DIRECTORIES AND FILES 


This chapter discusses use of RMS-11 directory and file operations. 
The next sections discuss information and usage common to several 
directory and file operations: 

e Device characteristics 

e Logical channels 

e File specifications and identifiers 

@ Private buffer pools 


e Completion status 


The sections after those provide an overview of the operations 
themselves (see Chapter 5 for detailed discussions): 


e Directory operations (except SEARCH): ENTER, REMOVE, RENAME 
and PARSE 


e File operations: CREATE, OPEN, DISPLAY, ERASE, EXTEND, and 
CLOSE 


Finally, the last sections discuss: 
e SEARCH operation 


@e Writing wildcard loops 


3.1 DEVICE CHARACTERISTICS 


A directory or file operation (except CLOSE, DISPLAY, or EXTEND) 
returns device characteristics. These characteristics are returned as 
masks in the 1l-byte DEV field of the FAB. The device characteristics 
are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a-unit-record device. 


Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the l-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 
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Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-11 treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


@e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


3.2 LOGICAL CHANNELS 


An RMS-11 directory or file operation (except CLOSE, DISPLAY, or 
EXTEND) requires a logical channel; this channel is a path from the 
program to a specified device. 


When your program executes a CREATE or OPEN operation on the channel, 
the path is extended to the target file; until the file is closed, 
the channel is reserved for the specified FAB. 


Your program specifies the logical channel for a directory operation 
or for a CREATE, ERASE, or OPEN operation in the l-byte LCH field of 
the FAB; the channel must not already be in use by the task. 


You can specify the initial device assignment for a logical channel in 
a Task Builder command file. The Task Builder also provides default 
initial device assignments for certain channels. Other logical 
channels are unassigned when your task begins executing. 


During task execution, channel assignments are made or changed by use 
of the ALUNS system directive. For example, RMS-11 uses the ALUNS 
directive to assign a logical channel for a directory operation or for 
a CREATE, ERASE, or OPEN operation; if the FAB and NAM block specify 
a device or device identifier, RMS-1ll assigns the channel to that 
device; if the FAB and NAM block do not specify a device or device 
identifier, RMS-11 retains the device-channel assignment (if any), or 
assigns the channel to the device SY:,. 


3.3 FILE SPECIFICATIONS AND IDENTIFIERS 


A file specification consists of the following elements (in the order 
given): 


@e Device specification - the device where the file resides 


@e Directory specification - the directory on the device through 
which the file can be found 


e File name - the name by which the file is known in the 
directory : 


e File type - the type by which the file is known in the 
directory 


e File version - the version number by which the file is known 
in the directory 
<— 
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RMS-11 operations construct and use file specification strings and 
file identifiers to specify files. These strings and identifiers 
include: 


User-provided file specification strings 
e Expanded file specification strings 
e Resultant file specification strings 
e File, directory, and device identifiers 


This section discusses these strings and identifiers as they are used 
for nonwildcard operations; wildcard use is described in Section 3.8. 


For a CREATE, ENTER, ERASE, OPEN, PARSE, REMOVE, or RENAME operation, 
your program specifies two strings to be used in generating a full 
file specification: 


e A file specification string, called the file string (your 
program specifies the address of the file string in the 1l-word 
FNA field of the FAB and the length of the string in the 
l-byte FNS field of the FAB) 


e A default file specification string, called the default string 
(your program specifies the address of the default string in 
the l-word DNA field of the FAB and the length of the string 
in the l-byte DNS field of the FAB) 


The operation routine uses these two strings to form an internal 
merged file specification string, called the merged string. The 
operation initially forms the merged string as follows: 


e It begins by taking available elements from the file string. 


e It then supplies missing elements from the default string (if 
they are available there). The operation (when it completes) 
returns masks describing the results of this merge in the 
l-word FNB field of the NAM block (if you supplied a NAM block 
for the operation). 


If elements are still missing from the merged string, the operation 
next adds the following elements: 


e Device ~- If the logical channel specified in the LCH field of 
the FAB is already assigned to a device, that device is used; 
otherwise the device SY: is used. 


e Directory - The task's current directory is used. 
e File name, type, and version ~ Nulls are used. 


If the operation is the PARSE operation, the merged string is 
complete. If . you provided a NAM block, the PARSE operation returns 
the device identifier in the 2-word DVI field of the NAM block; if 
you provided an expanded string buffer, the PARSE operation returns 
the expanded string in the expanded string buffer (whose address is in 
the 1l-word ESA field of the NAM block). (Note that the device 
specification in an expanded string has usually been translated to the 
specification for a physical device.) 
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An operation other than PARSE continues by examining the FBSFID mask 
in the FOP field of the FAB. If the FBSFID mask is set, the operation 
adds the following elements: 


Device - If a device identifier is given in the NAM block, 
that device overrides the device in the merged string and the 
device specification is deleted from the merged string. 


e Directory - If a directory identifier is given in the NAM 
block, that directory overrides the directory in the merged 
string and the directory specification is deleted from the 
merged string. 


e File identifier - If a file identifier is given in the NAM 
block and if the operation is ERASE or OPEN, that file 
overrides the directory, file name, type, and version in the 
merged string and the specifications for those elements are 
deleted from the merged string. 


The merged string is then copied to the expanded string buffer (if you 
supplied one) as described for the PARSE operation above. The merged 
string plus applicable identifiers are called the fully qualified file 
specification, and define the file upon which the operation will be 
performed. 


The device, directory, and file identifiers for the file are returned 
in the NAM block (if you supplied one). These identifiers can be used 
as input to subsequent directory and file operations to speed 
processing by eliminating directory and file lookups. 


Note that a complete file specification is relevant only to a disk 
file. The directory specification is not relevant for ANSI magtape 
files; only the device specification is relevant for a file on a 
unit-record device. Irrelevant elements are not processed, and appear 
in the expanded string only if your program provides them in the file 
string or default string. 


NOTE: NULL, 0, OR -] VERSION NUMBER 


If the version specification has not 
been deleted and is null, 0, or -l, it 
will later be replaced with the version 
number of the target file. 


A version number of -l identifies the 
target file as the (otherwise) specified 
file with the lowest version number; a 


version number of -1l is illegal for a 
CREATE or ENTER operation, or for _ the 
new file specification for a RENAME 
operation. 


For an ERASE, OPEN, REMOVE, or RENAME 
(old specification) operation, a null or 
0 version number specifies the target 
file as the (otherwise) specified file 
with the highest version number. 


For a CREATE, ENTER, or RENAME (new 
specification) operation, a null or 0 
version number specifies that the 
operation is to create a new entry whose 
version number is one greater than the 
highest—numbered version of the 
(otherwise) specified file. 
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3.4 PRIVATE BUFFER POOLS 


Many RMS-11 operations require space from a buffer pool. A directory 
or file operation (except CLOSE, DISPLAY, or EXTEND) allows your 
program to specify a private buffer pool. Your program specifies the 
address of the pool in the l-word BPA field of the FAB; it specifies 
the size (in bytes) of the pool in the l-word BPS field of the FAB. 


The CLOSE operation returns (in the BPA and BPS fields) the address 
and size of the private buffer pool (if any) specified for the CREATE 
or OPEN operation that opened the file; until the file is closed, the 
pool is dedicated to the open file and must not be used for other 
purposes. 


If your program does not specify a private buffer pool, the operation 
uses the central buffer pool (which your program declares using 
pool-declaration macros); if your program specifies a private buffer 
pool, the operation uses that pool. 

The CLOSE, DISPLAY, and EXTEND operations, and all stream, record, and 


block operations use the pool specified by the CREATE or OPEN 
operation that opened the file. 


3.5 COMPLETION STATUS 
A directory or file operation returns a completion status code in the 


l-word STS field of the FAB, and a completion status value in the 
l-word STV field of the FAB. 


3.6 DIRECTORY OPERATIONS 


RMS-11 directory operations affect only directory entries (not the 
contents of files). The directory operations are: 


@ ENTER: create a directory entry 

e@ REMOVE: delete a directory entry 

@ RENAME: replace a directory entry 

e PARSE: analyze a file specification 
e SEARCH: search directories 


The next sections provide an overview of the directory operations 
(except for the SEARCH operation, which is discussed in Section 3.8). 


3.6.1 ENTER Operation 


A file specified as temporary when it was created has no directory 
entry; a file also has no directory entry if the entry has been 
deleted by the REMOVE operation. 


Your program can use the ENTER operation to create a directory entry 
for a file; this makes it possible for your program (and other 
programs) to specify the file to RMS-1l by its file specification. 


The ENTER operation uses the device and directory elements of the 


fully qualified file specification to determine the target directory; 
it then creates an entry in that directory using the file name, type, 
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and version elements of the fully qualified file specification, and 
the file identifier specified in the NAM block. 


3.6.2 REMOVE Operation 


Your program can delete the directory entry for a file by using the 
REMOVE operation; this does not affect either the existence of the 
file or the file contents, but only removes the path to the file. 


The device and directory elements of the fully qualified file 
specification specify the target directory; the file name, type, and 
version elements of the fully qualified file specification identify 
the entry to be removed from the directory. 


3.6.3 RENAME Operation 


Your program can replace the directory entry for a file by using the 
RENAME operation. The fully qualified file specification for the new 
directory entry must not specify a new device for the file, but 
otherwise it can specify elements different from the old file 
specification: directory, file name, file extension, and file version 
number. 


If you do not specify a device, the device associated with the old 
file specification is used. 


For both the old and new directory entries, the RENAME operation uses 
the device and directory elements of the fully qualified file 
specification to determine the target directory; it uses the file 
name, type, and version elements of the fully qualified file 
specification to identify the entry to be removed or created. © 


3.6.4 PARSE Operation 
Your program can use the PARSE operation to analyze a file 
specification, or to prepare for a series of wildcard operations 


(described in Section 3.8). The results of the PARSE operation are 
described in detail in Section 3.3. 


3.7 FILE OPERATIONS 


RMS-1l1 file operations affect files as whole entities (but not 
individual records or blocks in files). The file operations are: 


@ CREATE: create a file (and a corresponding directory entry) 
and open the file for processing 


e OPEN: open an existing file for processing 
@ DISPLAY: write file information to control blocks 


ERASE: delete file contents (records or blocks) and remove 
directory entry 
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EXTEND: increase the allocation for a file 
CLOSE: close an open file 


The next sections discuss file operations. 


3.7.1 CREATE Operation 


The CREATE operation creates a new file and opens it for processing; 
unless the file is specified as a temporary file, the CREATE operation 
also creates a directory entry for the file. 


The CREATE operation uses the device and directory elements of the 
fully qualified file specification to determine the target directory; 
it then uses the file name, type, and version of the fully qualified 
file specification to form the entry in that directory. 


3.7.2 OPEN Operation 


Your program can establish an access path to a file by using the OPEN 
operation. This makes file information available to your program, and 
enables your program to use the following operations for the file: 


@ DISPLAY operation (to make more file information available to 
your program). 


e EXTEND operation (to allocate more space for the file). 

e CONNECT operation (to establish a path to file records or 
blocks). The CONNECT operation enables your program to use 
other stream operations and either record operations or block 
operations. 


e CLOSE operation (to release resources committed to the open 


file). The CLOSE operation terminates the access path 
established by the CREATE or OPEN operation that opened the 
file. 


3.7.3 DISPLAY Operation 


If your program uses the OPEN operation to open a file, but does not 
provide control blocks and buffers for all the information that the 
OPEN operation can return, you may want to use the DISPLAY operation 
to obtain additional information while the file is open. 


3.7.4 ERASE Operation 


Your program can erase the contents of a file by using the ERASE 
operation, and (optionally) remove its directory entry. 


Unless your program provides a file identifier in the NAM block and 
sets the FBSFID mask in the l~word FOP field of the FAB, the ERASE 
operation also removes the specified directory entry for the file. 
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The ERASE operation uses the fully qualified file specification to 
determine the target file. If the operation removes the directory 
entry, it uses the device and directory elements of the fully 
qualified file specification to determine the target directory, and 
the file name, type, and version elements to determine the entry to be 
removed. 


3.7.5 EXTEND Operation 


Your program can increase the allocation for an open file by using the 
EXTEND operation. Note that RMS-11 automatically extends the file 
allocation when it needs more space; you can use the EXTEND operation 
to make large extensions (avoiding repeated automatic extensions) or 
exact extensions (avoiding wasteful automatic extensions). 


3.7.6 CLOSE Operation 


Your program can close an open file by using the CLOSE operation. 
This releases task and system resources (other than the file itself) 
and makes those resources available for other uses. 


3.8 WRITING WILDCARD LOOPS 


You can include wildcard characters in an RMS-11 file specification 
and use the PARSE and SEARCH operations to identify files that match 
the wildcard specification. This allows you to program a wildcard 
loop that successively (and selectively, if you wish) processes files 
matching the wildcard specification, 


An advantage of RMS~1l wildcarding over system wildcard commands is 
that your processing can be selective. For example, if you use a 
system wildcard command to rename a group of files, the entire group 
is renamed; if you use a wildcard loop in a program, the program can 
fully examine information about each file and even the contents of 
each file to decide whether to rename it. 


The next three sections show: 


e The structure of a wildcard loop and the behavior of directory 
and file operations in the loop 


e How to write a wildcard loop that nonselectively uses the 
ERASE, REMOVE, or RENAME operation on successive matching 
files 


e How to write a wildcard loop that selectively performs 
directory and file operations on successive matching files 


3.8.1 Introduction to Wildcarding 


This discussion assumes that you want to write a program loop that 
uses a wildcard input file specification, and that you want to use the 
same control blocks (FAB and NAM block) for all operations associated 
with the wildcard loop. 
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A series of wildcard operations can be viewed as having four steps: 
Ll. Initializing for wildcarding 
2. Finding the next matching file 
3. Operating on the found file 
4. fading witdeardiag 


The next sections discuss these steps. 


3.8.1.1 Initializing for Wildcarding - The PARSE operation 
initializes control blocks (FAB and NAM block) for wildcard 
operations. Place the SPARSE macro before the wildcard loop in your 
program. 


The PARSE operation sets the NBSWCH mask in the l-word FNB field of 
the NAM block to show that wildcard operations are in progress. (Your 
program must clear the NBSWCH mask if it will not perform SEARCH 
operations after a PARSE operation.) 


The PARSE operation also forms a match-pattern in the expanded string 
buffer (whose address is in the l-word ESA field of the NAM block); 
this match-pattern is used by subsequent wildcard SEARCH operations. 


A series of SEARCH operations requires a NAM block that specifies both 
expanded string and resultant string buffers. (The resultant string 
buffer is specified in the l-word RSA field of the NAM block.) Your 
program must not alter the expanded string, the resultant string, or 
other NAM block contents between the PARSE operation and the end of 
the subsequent series of SEARCH operations. 


3.8.1.2 Finding the Next Matching File - The SEARCH operation finds 
the next file (if any) that matches the wildcard input file 
specification. (If the SEARCH operation cannot find another matching 
file, wildcarding ends; see Section 3.8.1.4.) 


The SEARCH operation returns a fully qualified file specification in 
the resultant string buffer, along with device, directory, and file 
identifiers for the found file. 


The SEARCH operation in your wildcard loop can either be explicit 
(your loop contains the S$SEARCH macro) or, for some operations, 
implicit (RMS-11 automatically performs the SEARCH Operation). If you 
use the explicit SEARCH operation, place the SSEARCH macro inside the 
loop but before other operation macros. 


If you use an ERASE, REMOVE, or RENAME (old FAB) operation in the loop 
with the FBSFID mask in the 1-word FOP field of the FAB cleared, 
RMS-11 implicitly performs a SEARCH operation (to find the next 
matching file) before performing the ERASE, REMOVE, or RENAME 
operation. This allows your wildcard loop to omit the $SEARCH macro. 
(If the implicit SEARCH operation cannot find another matching file, 
wildcarding ends; see Section 3.8.1.4.) 
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3.8.1.3 Operating on the Found File - A number of directory and file 
Operations are wildcard-transparent in the sense that they preserve 
both wildcard context information and information about the last-found 
file. This means that your program can use the operations within a 
wildcard loop without changing the wildcard context; the series of 
wildcard operations is continuable. 


The wildcard-transparent operations are CLOSE, DISPLAY, and EXTEND, 
and (if the FBSFID mask in the l-word FOP field of the FAB is set) 
ERASE, OPEN, REMOVE, and RENAME (old FAB). 


3.8.1.4 Ending Wildcarding - A series of wildcard operations (using a 
specific FAB and NAM block) ends when a directory or file operation 
discards wildcard context information or when your program clears’ the 
NBSWCH mask in the l-word FNB field of the NAM block. 


Typically, the operation that ends wildcarding is a SEARCH operation 
that cannot find another matching file. It returns the ERSNMF 
completion status code and clears the NBSWCH mask in the l-word FNB 
field of the NAM block. 


If your program exits from a wildcard loop before the SEARCH operation 
fails to find a matching file, the NBSWCH mask in the l-word FNB. field 
of the NAM block is still set, and your program must clear it. 


Executing the PARSE operation during a wildcard series ends’ that 
series and initializes control blocks for a new series. 


Executing a CREATE or ENTER operation, or an OPEN operation with the 
FBSFID mask in the l-word FOP field of the FAB cleared, ends the 
wildcard series for that FAB. 


3.8.2 Nonselective ERASE, REMOVE, or RENAME Wildcard Operations 


You can write a wildcard loop ‘that performs nonselective ERASE, 
REMOVE, or RENAME operations on successive matching files, where 
RMS~11 implicitly performs a SEARCH operation before each ERASE, 
REMOVE, or RENAME operation. 


To do this, do the following: 


1. Use the PARSE operation to initialize control block fields 
for wildcarding. 


2. Clear the FBSFID mask in the l-word FOP field of the FAB (for 
the RENAME operation, the old FAB). This causes the ERASE, 
REMOVE, or RENAME operation to perform an implicit SEARCH 
operation before performing its own processing. 


3. Use the ERASE, REMOVE, or RENAME operation to operate on the 
next matching file. 


4. Examine the STS field of the FAB. If it contains the  ERSNMF 
completion status code, there was not another matching file; 
in that case, go to step 7. 


5. Perform other in-loop processing (such as reporting the file 
specification of the erased, removed, or renamed file). 
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6. Go to step 2. 


7. The wildcard series is finished; continue with other 
processing. 


The following program segment illustrates this procedure, performing 
the ERASE operation. In the program segment, FABADR is a label giving 
the address of the FAB for the operations, and RO is used (for the 
SSTORE and SCOMPARE macros) to contain the address of the FAB. 


SPARSE #FABADR ;Set up for wildcarding 
LOOP: MOV #FABADR, RO ;FAB address to RO 

SOFF #FBSFID,FOP,RO ;Use implicit search 

+  (FBSFID off) 

SERASE #FABADR :Try to erase next file 

SCOMPARE #ERSNMF,STS,RO ;Was there a matching file? 

BEQ DONE :;No more matching files 

a ce :Other in-loop processing 

BR LOOP ;On to next matching file 
DONE: ae, bore sContinue with other 


+ processing 


3.8.3 Selective Wildcard Operations 


You can write a wildcard loop that performs directory and file 
operations on selected matching files, where your program explicitly 
performs a SEARCH operation at the beginning of each iteration of the 
loop. To do this, do the following: 


1. Use the PARSE operation to initialize control block fields 
for wildcarding. 


2. Use the SEARCH operation to obtain information about the next 
file that matches the wildcard specification. 


3. Examine the STS field of the FAB. If it contains the ERSNMF 
completion status code, there was not another matching file; 
in that case, go to step 6. 


4, Perform directory and file operations on the found file. Tf 
ERASE, OPEN, REMOVE, or RENAME operations are included, be 
sure the FBSFID mask in the l-word FOP field of the FAB (for 
the RENAME operation, the old FAB) is set. 


Do not perform CREATE, ENTER, or PARSE operations, or OPEN 
operations with the FBSFID mask cleared; these operations 
end wildcarding. 


Do not perform ERASE, REMOVE, or RENAME operations with the 
FBSFID mask cleared; these operations perform an implicit 
SEARCH operation, advancing to the next matching file. 

5. Go to step 2. 


6. The wildcard series is finished; continue with other 
processing. 
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The following program segment illustrates the procedure, performing 
the ERASE operation on selected files. In the program segment, FABADR 
is a label giving the address of the FAB for the operations, and RO is 
used (for the SCOMPARE macro) to contain the address of the FAB. 


SPARSE #FABADR 7Set up for wildcarding 
LOOP: SSEARCH #FABADR 7;Find next matching file 
MOV #FABADR,RO 7;FAB address to RO 
SCOMPARE #ERSNME,STS,RO ;Any more matching files? 
BEQ DONE ;No more matching files 
eee ta ;Decide whether to delete 
; file (if so, Z-bit on) 
BNE NOOP ;Don't delete file 
MOV #FABADR,RO ;FAB address to RO 
SSET #FBSFID,FOP,RO ;Explicit SEARCH already done 
SERASE #FABADR ;Erase file contents 
NOOP: ey a oe ;Other in-loop processing 
BR LOOP 7On to next matching file 
DONE: ea 4 ;Continue with other 


} processing 


CHAPTER 4 


PROCESSING RECORDS AND BLOCKS 


This chapter describes use of RMS-11 stream, record, and block 
operations; its major sections are: 


e Synchronous and asynchronous operations 
e Completion status 

e Streams 

e Record processing 


e Block processing 


4.1 SYNCHRONOUS AND ASYNCHRONOUS OPERATIONS 


An RMS-11 stream, record, or block operation executes either 
synchronously or asynchronously. 


4.1.1 Synchronous Operations 


If an operation executes synchronously, execution control is not 
returned to your program until the operation has completed; your 
program is idle during the operation's execution. To specify 
synchronous operation for a stream, record, or block operation, clear 
the RBSASY mask in the l-word ROP field of the RAB. 


4.1.2 Asynchronous Operations 


If an operation executes asynchronously, execution control may _ be 
returned to your program before the operation has completed; this 
allows your program to continue executing during the operation's 
execution. To specify asynchronous operation for a stream, record, or 
block operation, set the RBSASY mask in the l-word ROP field of the 
RAB. (You must also have specified the ASYN argument to the RABSB 
macro when you declared the RAB, and must select the asynchronous 
support modules when you task build your program.) 


Your program can, for example, specify an asynchronous write operation 
and continue its processing even while the file processor is waiting 
for access to the device. 
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Only one operation (either synchronous or asynchronous) at a time may 
be active for a_ stream. Your program must make sure that an 
asynchronous operation has completed either by using the WAIT 
operation or by using completion routines to set user-defined flags. 


During processing, RMS-11 guards against illegal interleaving of 
operations on the same file as follows: 


@ A file operation begins by verifying that no record operation 
is in progress for the target file. 


e A record operation begins by verifying that no file operation 
is in progress for the target file. 


e If a synchronous operation detects that it is executing within 
an asynchronous operation's completion handler, it verifies 
that no other record operation is in progress for the target 
file. 


If one of these verifications fails, the operation returns the ERSACT 
completion in the STS field of the FAB or RAB. 


If your program attempts an operation using a FAB or RAB that is 
already in use by another operation, the attempted operation returns 
the fatal completion ERSACT in RO (because the STS field of the FAB or 
RAB belongs to the other operation). 


If your program attemps a WAIT operation within the completion handler 
for an asynchronous operation, the attempted operation returns the 
fatal completion ERSAST in RO (because otherwise a deadlock could 
occur). 


4.2 COMPLETION STATUS 


A stream, record, or biock operation returns a completion status code 
in the l-word STS field of the RAB; it may also return a completion 
status value in the l-word STV field of the RAB. 


4.3 STREAMS 


A stream is a path from your program to the data in a file. The 
CONNECT operation establishes a stream; for the CREATE or OPEN 
operation that opened the file, your program specified either record 
access or block access. 


If it specified record access, the stream is a record stream and 
supports only stream operations and record operations; if it 
specified block access, the stream is a block stream and supports only 
stream operations and block operations. 


For the CONNECT operation, your program specifies the FAB for the file 
(in the l-word FAB field of the RAB), and the CONNECT operation 
returns an internal stream identifier (in the l-word ISI field of the 
RAB). All stream, block, and record operations (except CONNECT) 
identify the file using the internal stream identifier; the 
DISCONNECT operation terminates the stream, and clears the internal 
stream identifier. 
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4.4 RECORD PROCESSING 


This section describes use of RMS-11l record processing. Its 
subsections are: 


Record streams: the paths from your program to file records 
@ Record context: the "current location" of a stream in a file 
e Record access modes: the ways your program can access records 


@ Record buffers: the locations of records in your program's 
space 


@ Locate mode: a way of speeding record processing 
¢ Stream operations: stream operations for a record stream 


e Record operations: operations that access records 


4.4.1 Record Streams 


A record stream is a path from your program to the records ina file. 
Your program establishes a record stream when it uses the CONNECT 
operation to connect a stream to a file (opened for record access by 
an earlier CREATE or OPEN operation). A record stream supports stream 
operations and record operations, but not block operations. 


If the target file for a stream is a relative or indexed file, your 
program can establish more than one stream for the file; if, in 


addition, your program specifies access sharing, more than one _ task 
can establish streams for the file. 


4.4.2 Record Context 


A record stream has a record context, which consists of a 


current-record context and a next-record context. Some record 
operations use the current record or next record as the target for the 
operation; some stream and record operations change the 


current-record context, the next-record context, or both. 


The notion of "following record" is important to record context 
because the next-record context is often established as the record 
"Following" the current record. The precise meaning of "following 


record" depends on the file organization: 


e ina sequential file, the record following a given record is 
the one immediately following it in physical sequence. 


® Ina relative file, the record following a given record is the 
one in the first higher-numbered cell that contains a record. 


e In an indexed file, a record follows another only with respect 
to an index; each index imposes an order on the file records. 
The record following a given record (under a given index) is 
the record whose record key is the smallest in the file that 
is greater than the record key of the given record; among 
records having identical record keys, a record written later 
follows a record written earlier. 
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Note that although an operation may establish the next-record context, 
that context is not evaluated until another operation uses it. For 
example, if your program connects a stream to a relative file that 
contains records only in cells 5 and 10, a sequential access GET 
operation returns the record in cell 5 and establishes both 
current-record and next-record context; if another stream or task 
then inserts a record in cell 7 before your program executes a_ second 
sequential access GET operation, that GET operation returns the new 
record (cell 7), even though the record did not exist when the 
next-record context was established. 


4.4.3 Record Access Modes 


The record operations FIND, GET, and PUT allow your program to specify 
a record access mode (in the l-byte RAC field of the RAB); the record 
access mode determines the target record for the operation. The 
record access modes are: 


e Sequential access 
@e Key access 
e@ RFA access 


The next sections discuss these access modes. 


4.4.3.1 Sequential Access - Your program specifies sequential access 
by setting the RBSSEQ code in the l-byte RAC field of the RAB. A 
sequential access FIND or GET operation has as its target the next 
record, (Exception: a sequential access GET operation that 
immediately follows any FIND operation has as its target the current 
record, which is the record found by the FIND operation.) 


The target of a sequential access PUT operation depends on the file 
organization, as follows: 


e For a sequential file, a series of sequential access put 
operations must begin with the next-record context at the 
end-of-file. The series of PUT operations adds new records at 
the end-of-file. 


e For a relative file, a series of sequential access PUT 
operations must begin with the next-record context set such 
that the first cell examined is empty (unless the RBSUIF mask 
in the l-word ROP field of the RAB is set). The series of PUT 
operations adds new records in successive cells; if a 
nonempty cell is encountered, the PUT operation returns the 
ERSREX completion (unless the RBSUIF mask is set, in which 
case the existing record is overwritten). 


@ For an indexed file, a series of sequential access PUT 
operations does not depend on the next-record context; 
however, a PUT operation in the series returns the ERSSEQ 
completion if the value of the record primary key for the 
operation is less than the value of the record primary key for 
the preceding PUT operation. 


A sequential access FIND or GET operation sets the current-record 
context to the target record, and sets the next-record context to the 
record following the target record. Sequential access PUT operations 
leave both the current-record and next-record contexts undefined. 
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This targeting and context setting means, generally speaking, that a 
series of sequential access operations operates on successive records. 
Specifically, series of sequential access operations result as 
follows: 


A series of sequential access FIND operations sets the stream 
context to successive records. 


@e A series of sequential access GET operations reads successive 
records. 


e A series of sequential access PUT operations writes successive 
records (for an indexed file, possibly interspersed with 
existing records). 


e A series of paired sequential access FIND and sequential 
access GET operations reads successive records. 


4.4.3.2 Key Access - Your program specifies key access by setting the 
RBSKEY code in the l-byte RAC field of the RAB. A key access FIND, 
GET, or PUT operation has as its target the record that your program 
specifies by specifying the key. For a relative file or fora 
sequential disk file with fixed-length records, your program specifies 
the key as a relative record number. Specify the relative record 
number in the l-word KBF field of the RAB and the key size as 0 or 4 
in the l-byte KSZ field of the RAB. 


For a FIND or GET operation for an indexed file, your program 
specifies the index of reference and a key buffer that contains the 
record key. Specify the index of reference in the l-byte KRF field of 
the RAB, the address of the key buffer in the l-word KBF field of the 
RAB, and the key size in the l-byte KSZ field of the RAB. 


A key access FIND or GET operation sets the current-record context to 
the record that is the target of the operation; a key access PUT 
operation leaves the current-record context undefined. 

A key access FIND or PUT operation does not affect the next-record 
context; a key access GET operation sets the next-record context to 
the record following the target record. 


The target of a key access FIND, GET, or PUT operation depends on the 
operation and on the file organization: 


e For a relative file or for a sequential disk file with 
fixed-length records, the key is a positive integer and 
specifies the position of the record in the file. This key is 
the relative record number (RRN) for the record; RRN 1 
specifies the first record, and so forth. 


If your program sets the RBSKGT mask in the l-word ROP field 
of the RAB, a FIND or GET operation searches for a record 
whose RRN is greater than the given RRN; if it sets the 
RBSKGE mask in the l-word ROP field of the RAB, the operation 
searches for a record whose RRN is greater than or equal to 
the given RRN; if it sets neither of these masks, the 
operation searches for a record with the given RRN. 


PROCESSING RECORDS AND BLOCKS 


Note that a FIND, GET, or PUT operation to a relative file or 
to a sequential disk file with fixed length records returns 
the RRN for the target record in the 2-word BKT field of the 
RAB. 


For a FIND or GET operation to an indexed file, the key 
specifies a record in the file whose record key matches the 
given key. Your program specifies both the key to be matched 
and the file index; the key data type must agree with the key 
data type for the index (string, packed decimal, binary, or 
signed integer). 


For a string key, your program specifies the portion of the 
key that must be matched. If the value in the l-byte KSZ 
field of the RAB is nonzero but is smaller than the record 
key, then only that smaller initial portion of the key must 
match. 


If your program sets the RBSKGT mask in the l-word ROP field 
of the RAB, a FIND or GET operation searches for a record 
whose key is greater than the given key; if it sets the 
RBSKGE mask in the l-word ROP field of the RAB, the operation 
searches for a record whose key is greater than or equal to 
the given key; if it sets neither of these masks, the 
operation searches for a record whose key exactly matches the 
given key. 


e For a PUT operation to an indexed file, the key (for each 


index) is in the record. The operation has no true target; 
the record is inserted at the proper place and each index is 
updated. 


This targeting and context setting means that although the target of 
the key access operation is a random (selected) record, the record 
context allows subsequent sequential access processing. Therefore 
your program can use key access to "jump" to a selected point ina 
file, then use sequential access to process successive records. 


4.4.3.3 RFA Access - Your program specifies RFA access by setting the 
RBSRFA code in the l-byte RAC field of the RAB. An RFA access FIND or 
GET operation has as its target the record that your program specifies 
by RFA (record file address). (The FIND, GET, and PUT operations 
return the RFA for the target record; if your program saves the RFA, 
it can use RFA access for the record in subsequent FIND and GET 
operations.) Specify the RFA in the 3-word RFA field of the RAB. 


An RFA access FIND or GET operation sets the current-record context to 
the record that is the target of the operation. An RFA access FIND 
operation does not affect the next-record context; an RFA access GET 
operation set the next-record context to the record following the 
target record. 


This targeting and context setting means that although the target of 
the RFA access operation is a random (selected) record, the record 
context allows subsequent sequential access processing. Therefore 
your program can use RFA access to "jump" to a selected point ina 
file, then use sequential access to process successive records. 
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4.4.4 Record Buffers 


A PUT or UPDATE operation transfers a record from a record buffer (in 
your program's space) to a file; for a VFC record, the operation also 
transfers the fixed-length portion of thé record from a_ separate 
record header buffer. Your program specifies the address of the 
record buffer in the l-word RBF field of the RAB and the size of the 
record in the 1-word RSZ field of the RAB; for a VFC record, your 
program also specifies the address of the record header buffer in the 
l-word RHB field of the RAB. 


A GET operation transfers a record from a file to an RMS-11 internal 
I/O buffer and to a user buffer in your program's space. Your program 
specifies the address of the user buffer in the l-word UBF field of 
the RAB and its size in the l-word USZ field of the RAB. Along with 
the record, the GET operation returns the address of the record in the 
l-word RBF field of the RAB and its size in the l-word RSZ field of 
the RAB. ; 


For a VFC record, a GET operation also transfers the fixed-length 
portion of the record to a separate record header buffer in your 
program's space. Your program specifies the address of the record 
header buffer in the l-word RHB field of the RAB. 


Exception: if your program specifies locate mode for a GET operation, 
RMS-11 may not transfer the record to the user buffer; see the next 
section for a discussion of locate mode. 


4.4.5 Locate Mode 


The GET and PUT operations normally use RMS-1l internal I/O buffers as 
intermediate storage between your program's buffers (record or user 
buffers) and the file. By specifying locate mode for a GET or PUT 
operation, your program requests RMS-11 to transfer records only 
between its I/O buffers and the file, thus saving time. Your program 
specifies locate mode by setting the RBSLOC mask in the l-word ROP 
field of the RAB. 


If your program specifies locate mode for a GET operation, RMS-1l may 
transfer the record only to its internal I/O buffer (but not to the 
user buffer). The GET operation routine decides whether to honor’ the 
locate-mode request or to transfer the record to the user buffer 
anyway; the operation returns the address and size of the retrieved 
record (informing your program of the record's location -- the user 
buffer or the I/O buffer). 


If your program specifies locate mode for a PUT operation, RMS-11 
recognizes that the record may already be in its I/0 buffer and if so 
transfers it to the file from there. 


Your program has (in the l-word RBF field of the RAB) the address of a 
location (in the I/O buffer if possible, otherwise in the user buffer) 
that is suitable for building the next record; this address is 
returned either by a previous locate-mode PUT operation or by an 
initial locate-mode CONNECT operation. Therefore, if you use _ the 
CONNECT operation for a stream that will use locate-mode PUT 
operations, your program must specify locate mode for the CONNECT 
operation, and must specify a user buffer (the address in the l-word 
UBF field of the RAB and the size in the l-word USZ field of the RAB). 


Note that specifying locate mode for a PUT operation has no effect 
unless the file is sequential, the access mode is sequential, and the 
record format is other than stream record format. 
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4.4.6 Stream Operations 


Stream operations affect stream context and I/O buffers (but not file 
records). The stream operations for a record stream are: 


CONNECT: establish a record stream 
e FLUSH: write unwritten buffers for a stream 
e FREE: free locked bucket for a stream 
e NXTVOL: set stream context to beginning of next volume 
e REWIND: set stream context to beginning of current file 
@e WAIT: wait for completion of asynchronous operation 
@ DISCONNECT: terminate a record stream 


The next sections discuss these operations. 


4.4.6.1 CONNECT Operation - Your program uses the CONNECT operation 
to establish a record stream. (The stream is a record stream because 
your program specified record access for the CREATE or OPEN operation 
for the file.) 


The current-record context after a CONNECT operation is undefined; 
the next-record context is (by default) the first record in the file. 


For an indexed file, your program must specify an initial index of 
reference so that the record context is initialized properly. 


For a sequential file, your program can specify that the initial 
record context is to be at the end-of-file (instead of the beginning 
of the file); in that case, the next-record context after the 
operation is the end-of-file. 


For a sequential disk file, your program specifies the number of 
blocks in the I/0 buffer for the stream; for a relative or indexed 
file, your program specifies the number of I/0 buffers for the stream. 


If the stream will use locate-mode PUT operations, your program must 
also specify locate mode and supply a user buffer. The CONNECT 
operation returns the address of a location suitable for building the 
first record to be output; see Section 4.4.5. 


4.4.6.2 FLUSH Operation - Your program can use the FLUSH operation to 
write any unwritten buffers for a stream (for example, to increase 
data integrity by ensuring that all changes have been written to the 
file); the FLUSH operation does not affect record context, except 
that the current-record context is undefined for a following TRUNCATE 
or UPDATE operation to a sequential file. 


Note one special case: if the file was opened for deferred writing, 
but not for write sharing, then the buffer may be controlled by 
another record stream and will not be written by the FLUSH operation. 
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4.4.6.3 FREE Operation - Your program can use the FREE operation to 
free a locked bucket for a stream; the FREE operation does not affect 
stream context, except that the current-record context is undefined 
for a following DELETE, TRUNCATE, or UPDATE operation. 


4.4.6.4 NXTVOL Operation - Your program can use the NXTVOL operation 
to advance the context for a stream to the beginning of the next 
magtape volume. The current-record context after the operation is 
undefined; the next-record context is the first record of the new 
volume. : 


4.4.6.5 REWIND Operation - Your program can use the REWIND operation 
to reset the context for a stream to the beginning-of-file or, for a 
multivolume magtape file, the beginning-of-volume (if it is not the 
first volume of the file). 


The current-record context after the operation is undefined; the 
next-record context is the first record in the volume (for a 
multivolume magtape file) or the file; for an indexed file, your 


program specifies the index of reference for the operation so that the 
stream context is initialized properly. 


4.4.6.6 WAIT Operation - When your program uses asynchronous 
operation for a stream, it must eventually use the WAIT operation to 
suspend processing until the asynchronous operation has completed; 
the WAIT operation does not affect stream context. 


4.4.6.7 DISCONNECT Operation - Your program can use the DISCONNECT 
operation to terminate a record stream, thus recovering the resources 
committed for the stream (primarily pool space). The DISCONNECT 
operation also discards record context and the internal stream 
identifier. 


4.4.7 Record Operations 


Record operations affect stream context, buffers (1/0, user, and 
record), and file records. The record operations are: 


e FIND: transfer a record from a file to an I/O buffer 


e GET: transfer a record from a file to an I/O buffer and to a 
user buffer 


@® PUT: transfer a record from a user buffer to a file 
@ DELETE: remove a record from a file 
@e UPDATE: replace a record in a file 


TRUNCATE: remove the current record and all following records 
from a sequential file 


The next sections discuss these operations. 
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4.4.7.1 FIND Operation -— Your program can use the FIND operation to 
transfer a record (or part of a record) from a file to an I/0 buffer; 
the FIND operation does not transfer the record to a user buffer. 


Your program specifies an access mode (sequential, key, or RFA) for 
the FIND operation; Section 4.4.3 describes the target record and 
context-setting for the FIND operation (Section 4.4.3.1 for sequential 
access, 4.4.3.2 for key access, and 4.4.3.3 for RFA access). 


For a relative file or for a sequential disk file with fixed-length 
records, the FIND operation returns the relative record number (RRN) 
and the record file address (RFA) for the found record; for other 
files, the FIND operation returns only the RFA for the found record. 


4.4.7.2 GET Operation - Your program can use the GET operation to 
transfer a record from a file to an I/O buffer and to a user buffer 
(which your program specifies). 


Your program specifies an access mode (sequential, key, or RFA) for 
the GET operation; Section 4.4.3 describes the target record and 
context-setting for the GET operation (Section 4.4.3.1 for sequential 
access, 4.4.3.2 for key access, and 4.4.3.3 for RFA access). 


The GET operation returns the address and size of the retrieved 
record, along with its RFA; for a relative file or for a sequential 
disk file with fixed-length records, the GET operation also returns 
the RRN for the retrieved record. 


If your program specifies locate mode for the GET operation, it must 
also specify a user buffer; see Section 4.4.5. 


4.4.7.3 PUT Operation - Your program can use the PUT operation to 
transfer a record from a user buffer to an I/O buffer and to a file. 


Your program specifies an access mode (sequential or key) for the PUT 
operation; Section 4.4.3 describes the target record and 
context-setting for the PUT operation (Section 4.4.3.1 for sequential 
access, 4.4.3.2 for key access). 


Your program can specify that RMS-~11l must honor bucket fill numbers. 


For an indexed file, your program can specify that each PUT operation 
in a series is part of a mass insertion; for a relative file, your 
program can specify that the PUT operation should overwrite the target 
record (if any). 


The PUT operation returns the RFA for the inserted record; for a 
relative file or for a sequential disk file with fixed-lentgh records, 
the PUT operation also returns the RRN for the inserted record. 


If your program specifies locate mode for the PUT operation, it must 
also specify a user buffer. The PUT operation returns the address of 
a location suitable for building the next output record; see Section 
4.4.5. 
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4.4.7.4 DELETE Operation - Your program can use the DELETE operation 
to remove a record from a relative or indexed file. The target of a 
DELETE operation is the current record. 


The current-record context after a DELETE operation is undefined; the 
next-record context is unchanged. 


For an indexed file, your program can specify that RMS-1l must use the 
fast-deletion procedure. However, this procedure is faster because it 
deletes only those alternate index pointers that it must; future 
retrieval operations may be slowed by the presence of undeleted 
alternate index pointers. 


4.4.7.5 UPDATE Operation - Your program can use the UPDATE operation 
to transfer a record from a user buffer to a file (overwriting the 
existing record). The target of the UPDATE operation is the current 
record, which is overwritten. 


The current-record context after an UPDATE operation is undefined; 
the next-record context is unchanged. 


Your program specifies the record buffer for the record to be inserted 
(and, for a VFC record, the VFC-header buffer). 


va 


4.4.7.6 TRUNCATE Operation - Your program can use _ the TRUNCATE 
operation to remove the current record and all following records 
(through the end-of-file) from a sequential file. The current-record 
context after a TRUNCATE operation is undefined; the next-record 
context is the new end-of-file. 


4.5 BLOCK PROCESSING 


This section describes use of RMS-11 block processing. Its 
subsections are: 


e Block streams: the paths from your program to file blocks 
e Block context: the "current location" of a stream in a file 
e Block access modes: the ways your program can access blocks 


e Block buffers: the locations of blocks in your program's 
space 


e Stream operations: stream operations for a block stream 


e Block operations: operations that access blocks 


4.5.1 Block Streams 


A block stream is a path from your program to the blocks in aé_ file. 
Your program establishes a block stream when it uses the CONNECT 
operation to connect a stream to a file (opened for block access by an 
earlier CREATE or OPEN operation). A block stream supports stream 
operations and block operations, but not record operations. 
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4.5.2 Block Context 


A block stream has a block context, which consists of a readable-block 
context and a writable-block context. The READ operation uses the 
readable-block as its target block; the WRITE operation uses’ the 
writable-block as its target block; block operations change both the 
readable-block and the writable-block contexts. 


For a disk file, your program can use the READ or WRITE operation to 
read or write multiple blocks in a single operation. In that case, 
reading or writing begins at the readable block or the writable block 
(respectively), and continues through the number of blocks requested. 


4.5.3 Block Access Modes 


The block operations READ and WRITE allow your program to specify a 


block access mode (in the 2-word BKT field of the RAB); the block 
access mode determines the target block for the operation. The block 
access modes are: 

e Sequential access 

e VBN access 
For a magtape file, your program can use either sequential block 


access or VBN access; however, the program must access one block at a 
time, and in sequential order (unless it uses the SPACE operation to 
position the magtape). 


The next sections discuss these access modes. 


4.5.3.1 Sequential Access - Your program specifies sequential block 
access by giving the value 0 in the 2-word BKT field of the RAB. A 
sequential access READ operation has as its target the readable block; 
it sets the readable-block context to the next-following unread block, 


and sets the writable-block context to the target block (first block 
read for that READ operation). 
A sequential access WRITE operation has as its target the writable 


block; it sets both the readable-block and writable-block contexts to 
the next-following unwritten block. 


This targeting and context setting has the following results: 


e A series of sequential access READ operations reads successive 


blocks. 

® A series of sequential access WRITE operations writes 
successive blocks. 

e A series of paired READ and WRITE operations updates 
successive blocks. 
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4.5.3.2 VBN Access - A VBN access READ or WRITE operation reads or 
writes blocks beginning with a virtual block that your program 
specifies. Specify the virtual block number in the 2-word BRKT field 
of the RAB, 


Note that your program can use VBN access to move to a random position 
in a disk file, and then use sequential block access to process blocks 
sequentially from that point. 


4.5.4 Block Buffers 


Your program specifies a user buffer for the READ operation; the 
operation returns the address of the first-read byte and the number of 
bytes read. Specify the address of the user buffer in the l-word UBF 
field of the RAB and its size in the l-word USZ field of the RAB; the 
READ operation returns the address of the first-read byte in the 
l-word RBF field of the RAB and the number of bytes read in the l-word 
RSZ field of the RAB. 


Your program specifies the buffer containing the writable data for the 


WRITE operation. Specify the buffer address in the l-word RBF field 
of the RAB and its size in the l-word RSZ field of the RAB. 


4.5.5 Stream Operations 


Stream operations affect stream context and I/O buffers (but not file 
blocks). The stream operations for a block stream are: 


e CONNECT: establish a block stream 

@e FREE: free a locked block for a stream 

@ WAIT: wait for completion of asynchronous operation 
@e DISCONNECT: terminate a block stream 


The next sections discuss these operations 


4.5.5.1 CONNECT Operation - Your program uses the CONNECT operation 
to establish a block stream. (The stream is a block stream because 
your program specified block access for the CREATE or OPEN operation 
for the file.) 


After a CONNECT operation, both the readable-block and writable-block 
contexts are the first block in the file, 


4.5.5.2 FREE Operation - Your program can use the FREE operation to 
free a locked block for a stream; the FREE operation does not affect 
stream context. 
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4.5.5.3 WAIT Operation - When your program uses asynchronous 
operation for a stream, it must eventually use the WAIT operation to 
suspend processing until the asynchronous operation has completed; 
the WAIT operation does not affect stream context. 


4.5.5.4 DISCONNECT Operation - Your program can use the DISCONNECT 
operation to terminate a block stream, thus recovering the resources 
committed for the stream. The DISCONNECT operation also discards 
block context and the internal stream identifier. 


4.5.6 Block Operations 


Block operations affect stream context, block buffers, and file 
blocks. The block operations are: 


e READ: transfer blocks from a file to a block buffer 
e@ WRITE: transfer blocks from a block buffer to a file 
e SPACE: set block context for a magtape file 


The next sections discuss these operations. 


4.5.6.1 READ Operation - Your program can use the READ operation to 
transfer blocks from a file to a block buffer. Your program specifies 
an access mode (sequential or VBN) for the READ operation; Section 
4.5.3.1 describes sequential access; Section 4.5.3.2 describes VBN 
access. 


4.5.6.2 WRITE Operation - Your program can use the WRITE operation to 
transfer. blocks from a block buffer to a file. Your program specifies 


an access mode (sequential or VBN) for the WRITE operation; Section 
4.5.3.1 describes sequential access; Section 4.5.3.2 describes VBN 
access. 


Note that because the WRITE operation always writes to the file 
immediately, the FLUSH operation has no use for block access. 


4.5.6.3 SPACE Operation - Your program can use the SPACE operation to 
set block context for a magtape file; the context is moved forward or 
backward the specified number of blocks. After a SPACE operation, 
both the readable-block and writable-block contexts are the specified 
block. 


CHAPTER 5 


OPERATION MACRO DESCRIPTIONS 


This chapter describes RMS-11 operation macros and the operation 
routines they call. Each section of the chapter describes an 
operation macro and its corresponding operation. (For the SFIND, 
SGET, SPUT, SREAD, and SWRITE macros, there is a separate description 
for each access method.) 
Each description is divided into the following parts: 

e FORMAT - the format for the macro and its parameters 


e CONTROL BLOCKS - the required and optional control blocks for 
the operation 


e OPTIONS -—- the options that you can select for the operation, 
and the control block fields and values that control the 
options 

e@ STREAM CONTEXT - the current-record and next-record contexts 
(for a record stream) or the readable-block and writable-block 
contexts (for a block stream) after the operation completes 


e RETURNED VALUES - the values that the operation routine 
returns in control block fields and buffers 


e CHECKLISTS - a list of the control block fields that you 
supply to specify options, anda list of the control block 
fields that contain returned values 

The operation macros are: 

e SCLOSE - Close an open file 

e SCONNECT - Connect a record stream to an open file 

e SCREATE - Create a new file and open it for processing 

e SDELETE - Remove a record from a file 

e SDISCONNECT - Disconnect a record stream 

@ SDISPLAY - Write file data into control block fields 

e SENTER - Enter a file specification into a directory 

e SERASE - Erase an existing file 
SEXTEND - Extend the allocation for an open file 


SFIND - Set the stream context to a record ina file 
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SFLUSH - Write any unwritten buffers for a stream 
SFREE - Unlock a bucket locked by a stream 
SGET - Retrieve a record from a file 


@ SNXTVOL - Set stream context to the beginning of the next 
magtape volume 


e SOPEN - Open an existing file 

e SPARSE - Write file data into a NAM block 

e SPUT - Insert a record into a file 

e SREAD - Read blocks from a file 

e@ SREMOVE - Delete a file specification from a directory 


e SRENAME 


Rename an existing file 


e SREWIND Set stream context to beginning-of-file 

e SSEARCH - Search directories for a file specification 

e SSPACE - Move magtape block stream context forward or backward 
e STRUNCATE - Remove all following records from a file 

e SUPDATE - Replace a record ina file 


@ SWAIT - Wait for asynchronous completion for stream 


e SWRITE - Write blocks into a file 
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5.1 $CLOSE MACRO 


The SCLOSE macro calls the CLOSE operation routine to close an open 
file. 


FORMAT 
The format for the SCLOSE is: 2 
SCLOSE fabaddr[,[erraddr] [,sucaddr]] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the CLOSE operation. 


If you supply a PRO block, the CLOSE operation reads its fields to 
obtain new owner and protection codes for the file. 


To supply XABsS (ALL, DAT, KEY, PRO, and SUM blocks) for the CLOSE 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


Internal File Identifier 


The CLOSE operation reads the internal file identifier for the file 
from the l-word IFI field of the FAB. This identifier was written by 
the CREATE or OPEN operation when the file was opened. 


File Owner and Protection 


If you want to change the owner of the target file, specify the 
project (or group) portion of the owner code in the l-word PRJ field 
of the PRO block, and specify the programmer (or member) portion in 
the l-word PRG field of the PRO block; if you specify 0 for both 
these fields, the PRO block (including the PRO field) is ignored. 


If you want to change the file protection for the target file, specify 
the protection code in the 1-word PRO field of the PRO block (and 
specify a nonzero value in the PRG or PRJ field); if you specify 0 in 
this field, the operating system uses its defaults. 
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Rewinding Magtape 

For a magtape file, if you want the magtape rewound when the file is 
closed, set the FBSRWC mask in the l-word FOP field of the FAB. Note 
that if the FBSRWC mask was set when the file was opened (by the 
CREATE or OPEN operation), setting the mask has no effect for the 
CLOSE operation. 

STREAM CONTEXT 

The CLOSE operation destroys stream context for any streams connected 


by the closing file (after writing any unwritten buffers for those 
streams). 


RETURNED VALUES 


Private Buffer Pool 

The CLOSE operation writes the address of the private buffer pool (if 
any) for the file in the l-word BPA field of the FAB; if the CLOSE 
operation clears the BPA field, the file had no private buffer pool. 
If the file had a private buffer pool, the CLOSE operation writes the 
size (in bytes) of the pool in the l-word BPS field of the FAB, or 
clears this field if the file did not use a private buffer pool. 


Internal File Identifier 


The CLOSE operation clears the l-word IFI field of the FAB. 


Completion Status and Value 


The CLOSE operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-1 lists control block fields that are input to the CLOSE 
operation. Table 5-2 lists control block fields that are output by 
the CLOSE operation. 
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Table 5-1: CLOSE Input Fields 


a a a rT 


Block Field 


Description 


a 


ALL 
ALL 
DAT 
FAB 


AID 
NXT 
NXT 
FOP 


Area number 

Next XAB address 

Next XAB address 

File processing option mask 


FBS RWC Rewind magtape after closing file 


Internal file identifier 

XAB address 

Index reference number 

Next XAB address 

Next XAB address 

Programmer or member portion of file owner code 
Project or group portion of file owner code 
File protection code 

Next XAB address 


Table 5-2: CLOSE Output Fields 


ee A 


Block Field 


Description 


ee Se ee 


Private buffer pool address 
Private buffer pool size (bytes) 
Internal file identifier 
Completion status code 
Completion status value 
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The SCONNECT macro calls the CONNECT operation routine to connect a 
record stream to an open file, and initialize the stream context. 
FORMAT 
The format for the SCONNECT is: 

SCONNECT rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 
You must supply a RAB for the CONNECT operation. 


You must supply a FAB for the CONNECT operation. 
OPTIONS 


File Identification 


Specify the address of the FAB in the l-word FAB field of the RAB. 
The CONNECT operation reads the internal file identifier for the file 
from the l-word IFI field of the FAB. 


I/O Buffers > 


For a sequential disk file, specify the size (in blocks) of the RMS-11 
I/O buffer for the stream in the l-byte MBC field of the RAB; the 
largest legal value is 63. If you specify 0, the CONNECT operation 
uses a buffer of one block. For a relative file, an indexed file, or 
a sequential nondisk file, the CONNECT operation ignores the MBC 
field. 


For a relative or indexed file, specify the number of I/0 buffers’ for 
the stream in the l-byte MBF field of the RAB. For a sequential file, 
specify 0 in the MBF field. If you specify 0, the CONNECT operation 
uses the minimum number of buffers: one for a sequential or relative 
file, or two for an indexed file. 


User Buffer (Locate Mode for Sequential File) 


If you are connecting to a sequential file, and if you intend to 
execute PUT operations in locate mode for the connected stream, then: 


e Specify the address of the user buffer in the l-word UBF field 
of the RAB. 


Specify the size (in bytes) of the user buffer in the 1-word 
USZ field of the RAB. 


Set the RBSLOC mask in the l-word ROP field of the RAB. 


OPERATION MACRO DESCRIPTIONS 
SCONNECT MACRO 


This assures proper handling of the first PUT operation for the 
stream. 


Key of Reference (Indexed File) 


For an indexed file, specify the key of reference in the 1-byte KRF 
field of the RAB. This value specifies the index to be used in 
establishing initial record context: 0 for the primary index, 1 for 
the first alternate index, and so forth. 


Initial Stream Context (Sequential File) 


If you want to initialize the next-record context of a sequential file 
to the end-of~file, set the RBSEOF mask in the l-word ROP field of the 
RAB; if you do not set this mask, the CONNECT operation initializes 
the next-record context to the first record in the file (or to the 
end-of-file if the file is empty). 


Asynchronous Operation 


If you want to execute the CONNECT operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the CONNECT operation executes synchronously. (Your 
program must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


For a record-access file, the current-record context after a CONNECT 
operation is undefined; the next-record context is the first record 
in the file (under the specified index for an indexed file), or the 
end-of-file, if the file is empty. 


For a block-access file, both the readable-block and writable-block 
contexts after a CONNECT operation are the first block in the file. 


RETURNED VALUES 


Internal Stream Identifier 


The CONNECT operation writes an internal stream identifier in the 
l-word ISI field of the RAB. Do not destroy this identifier; all 
other stream, record, and block operation routines read it. 


Record Buffer 


The CONNECT operation copies the value from the UBF field into the 
l-word RBF field of the RAB (the record address); this prepares the 
record buffer for your use in case the first record operation for the 
stream is a locate-mode PUT operation to a sequential file. 


RFA 


For block access, the CONNECT operation returns the logical 
end-of-file value in the 3-word RFA field of the RAB. The first two 
words of this field are the VBN in which the logical end-of-file 
occurs, and the third word is the offset of the first byte beyond the 
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logical end-of-file within that block. This logical end-of-file value 
is meaningful only for disk files. 


Completion Status and Value 


The CONNECT operation returns completion status in the 1l-word SsTS 
field of the RAB and returns a completion value in the l-word STV 
field of the RAB. Appendix A lists completion status symbols and 
values. 


CHECKLISTS 


Table 5-3 lists control block fields that are input to the CONNECT 
operation. Table 5-4 lists control block fields that are output by 
the CONNECT operation. 


Table 5-3: CONNECT Input Fields 


A 


Block Field Description 


a 


FAB IFI Internal file identifier 

RAB FAB FAB address 

RAB KRF Key of reference 

RAB MBC Multiblock count 

RAB MBF Multibuffer count 

RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSEOF Position to end-of-file 
RBSLOC Locate mode 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


a nnn 


Table 5-4: CONNECT Output Fields 


a 


Block Field Description 
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RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB RFA End-of-file address 

RAB sts Completion status code 

RAB STV Completion status value 


i 
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5.3 SCREATE MACRO 


The SCREATE macro calls the CREATE operation routine to create a new 
file and open it for processing. 


FORMAT 
The format for the SCREATE is: 
SCREATE fabaddr[,[erraddr] [,sucaddr] ] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the CREATE operation. 


If you supply a NAM block, the CREATE operation reads its fields to 
obtain the expanded string buffer, and writes identifiers in its 
fields. 


To supply a NAM block for the CREATE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


Each ALL block that you supply defines one area in the created file, 
and you can place the area at a specific location. If you supply no 
ALL blocks, the file has one area; you define this area in the FAB, 
but you cannot place the area at a specific location. You cannot 
Supply more than one ALL block for a sequential or relative file. 


Each KEY block that you supply defines one index for the created file. 
You must supply at least one KEY block for an indexed file; you 
cannot supply KEY blocks for a relative or sequential file. 


If you supply a PRO block, the CREATE operation reads its fields to 
obtain the protection for the file. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the CREATE 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers must be consecutive 
beginning with 0. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers must be consecutive beginning with 
0. 


Multiple DAT, PRO, or SUM XABs are illegal. 


Note that if the LAN field of a KEY XAB is 0, RMS-11 will use the area 
specified in the IAN field for the lowest level index for that index. 
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OPTIONS 


File Specification 


The CREATE operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-ll defaults (which contribute 
elements not present in either the file string or the default string). 


RMS-11 defaults are: 


e® Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@ Directory -- The current directory for the task. 
e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the CREATE 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
CREATE operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the CREATE operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the CREATE operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


Expanded String Buffer 


If you want the CREATE operation to return the expanded string for the 
created file, provide a buffer for the string. Specify the address of 
the expanded string buffer in the l-word ESA field of the NAM block 
and its size (in bytes) in the l-byte ESS field of the NAM block; if 
you specify 0 in the ESS field, the CREATE operation does not return 
the expanded string. 


Supersession of Existing File 


If you want to create a file that supersedes an existing file with the 
same specification, set the FBSSUP mask in the l-word FOP field of the 
FAB; if you do not set the FBSSUP mask, and you specify a file that 
already exists, the CREATE operation returns an error completion and 
does not create the new file. 
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Temporary or Marked-for-Delete File 


If you want the created file to be a temporary file (one that has no 
directory entry), set the FBSTMP mask in the l-word FOP field of the 
FAB; if you do not set the FBSTMP mask, the created file has a 
directory entry. 


If you want the created file to be deleted when it is closed, set the 
FBSMKD mask in the 1l-word FOP field of the FAB; this causes the 
operating system to delete the file when it has no accessing programs. 
If you do not set the FBSMKD mask, the created file is not marked for 
deletion. 


If you want the created file to be a temporary file that is marked for 
deletion, set the FBSTMD mask in the l-word FOP field of the FAB; the 
FBSTMD mask includes the bits for both the FBSTMP and the FBSMKD 
masks. 


File Protection 


Specify the protection for the created file in the l-word PRO field of 
the PRO block; if you supply no PRO block, the operating system uses 
its default file protection. 


File Organization 


Specify a file organization code in the l-byte ORG field of the FAB. 
The symbols for file organization codes are: 


FBSIDX Indexed file organization 
FBSREL Relative file organization 
FBSSEQ Sequential file organization 


Record Format 


Specify the record format code in the l-byte RFM field of the FAB. 
The symbols for record format codes are: 


FBSFIX Fixed-length record format 
FBSSTM Stream record format 

FBSUDF Undefined record format 
FBSVAR Variable-length record format 
FBSVFC VFC record format 


If you specify VFC record format (FBSVFC code in the REM field), 
specify the size (in bytes) of the VFC header field in the l-byte FSZ 
field of the FAB; if you specify 0, the CREATE operation uses’ the 
value 2. 


Blocked Records 


If you are creating a sequential disk file, and if you want the file 
to contain blocked records (records that cannot span _ block 
boundaries), set the FBSBLK mask in the l-byte RAT field of the FAB; 
if you do not set the FBSBLK mask, records can span block boundaries. 
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If you are creating a relative or indexed file, the FBSBLK mask has no 
effect on storage of records in the file. However, this mask will be 
preserved and returned on OPEN operations. The FBSBLK mask is ignored 
for files on unit-record devices. 


Note that records are always blocked in a magtape file, regardless of 
the FBSBLK setting. 


Record-Output Handling 


Specify a record-output mask in the l-byte RAT field of the FAB. This 
record-output attribute controls the handling of records that are 
output to a unit-record device: 


e® FORTRAN-style record-output specifies FORTRAN-style 
carriage-control handling. 


@ Carriage-return record-output specifies that a prefixed 
linefeed and a suffixed carriage-return must be added to each 
record on output to a print device. 


e Print-format record-output specifies that the file is in print 
format. This format is allowed only for files with VFC 
records for which the fixed header size for each record is 0 
or 2 bytes. (RMS-1l treats a header size of 0 as if you had 
specified 2.) 


When records from the file are written directly to a 
unit-record device, RMS-11l interprets the first byte of the 
VFC header as a prefix for the record and the second byte of 
the header as a suffix for the record. RMS-11 further 
interprets the prefix/suffix control bytes as follows: 


If the top bit of the control byte is clear, the entire byte 
is used as a count of the number of carriage return/line feed 
pairs with which to prefix or suffix the record. 


If the top bit of the control byte is set, the low 5 bits. of 
the byte are used as the prefix or suffix character. 


If you specify none of these attributes, records are output to 
unit-record devices without special handling. 


If you are creating a file on a device other than a_unit-record 
device, the record output mask has no effect on storage of records in 
the file. However, this mask will be preserved and returned on OPEN 
operations. 


The symbols for record-output masks are: 


FBSCR Add CRLF to print record (LF-record-CR) 
FBSFTN FORTRAN-style carriage-control character in record 
FBSPRN VEC print record handling 


Record Size 


Specify the record size (in bytes) in the l-word MRS field of the FAB 
(unless you have specified undefined record format). For fixed-length 
records, the CREATE operation uses this value as the record size; for 
variable-length records, the CREATE operation uses this value as the 
maximum record size; for VFC records, the CREATE operation uses this 
value as the maximum size of the variable portion of each record. 
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If you specify a nonzero value in the MRS field, RMS-1ll checks’ the 
size of each record written to the file against the MRS-field value, 
and returns an error completion if the record size is inappropriate; 
if you specify 0 in the MRS field, RMS-11 does not check record sizes 
against the MRS-field value. 


Maximum Record Number 


If you specify relative file organization (FBSREL value in the ORG 
field), specify the maximum record number in the 2-word MRN field of 
the FAB. If you specify a nonzero value in the MRN field, RMS-11 
checks the record number of each record written to the file against 
the MRN-field value, and returns an error completion if the record 
number is too large; if you specify 0 in the MRN field, RMS-11 does 
not check record numbers against the MRN-field value. ; 


Private Buffer Pool 


If you want the CREATE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the CREATE 
operation uses the central buffer pool. ; 


The pool that the CREATE operation uses is also used by the DISPLAY 
and EXTEND operations, and by stream and record operations while the 
file is open. 


Logical Channel 


Specify the logical channel for the CREATE operation in the 1l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


The logical channel that the CREATE operation uses is also used by the 
DISPLAY and EXTEND. operations, and by stream and record or block 
operations while the file is open. 


Retrieval Pointers 


Specify the number of retrieval pointers for the open file in the 
l-byte RTV field of the FAB. If you specify 0, the CREATE operation 
uses the operating system default; if you specify -1l, the CREATE 
operation maps as much of the file as possible. 
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Requested Access 


Specify one or more requested-access masks in the l-byte FAC field of 
the FAB. This mask determines the access that the creating program 
has while the file is open. Regardless of what you specify, the 
CREATE operation includes the mask FBSPUT (for record access) or 
FBSWRT (for block access). The symbols for requested-access masks 
are: 


FBSDEL Request find/get/delete access 
FBSGET Request find/get access 

FBSPUT Request put access 

FBSREA Request block read access 

FBSTRN Request find/get/truncate access 
FBSUPD Request find/get/update access 
FBSWRT Request block write access 


Note that FBSREA and FBSWRT override any record access requested, 


Access Sharing 


Specify the kinds of access that your program is willing to share with 
other programs by setting an access-sharing mask in the l-byte SHR 
field of the FAB. The symbols for access-—sharing masks are: 


FBSGET Share find/get access 

FBSNIL No access sharing 

FBSWRI Share find/get/put/update/delete access 
FBSUPI Share any access (user-provided interlock) 


The kinds of access sharing are: 
e Shared read access 


Your program is willing to allow other programs to read the 
file, but not to write it. 


e Shared write access 


Your program is willing to allow other programs to both read 
and write the file. Shared write access is not allowed for a 

- sequential file unless the file has undefined record format 
and your program opens the file for block access; shared 
write access is also not allowed for a relative or indexed 
file that your program opens for block access. In such cases, 
RMS-11 automatically converts’ the shared write access 
specification to a shared read access specification 
internally. 


@ No shared access 


Your program is not willing to allow other programs to either 
read or write the file. RMS-11 does, however, allow other 
programs to read the file unless your program also requests 
some form of write access (which is always the case for 
CREATE) . 


User-provided interlocking 


Your program and other cooperating programs define and enforce 
their own access interlocking; RMS-11 does not check access 
sharing. User-provided interlocking is allowed only for 
sequential disk files; otherwise, the FBSUPI mask is ignored 
(but other masks are honored). 
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Deferred Writing 


If you want deferred buffer writing for the open file, set the FBSDEW 
mask in the l-word FOP field of the FAB; This means that RMS-11 does 
not necessarily write its buffers during a write-type operation 
(DELETE, PUT, or UPDATE), but instead writes buffers only when it 
needs them for other operations (or when your program executes the 
FLUSH operation for the stream). 


If you do not set the FBSDFW mask, the DELETE, PUT, and UPDATE 
operations write buffers to the file immediately. 


Note that record operations always use a form of deferred buffer 
writing for sequential files, and that block operations never use 
deferred buffer writing. Therefore you need only decide whether to 
use deferred writing for a record stream to a relative or indexed 
file. 


File Locking 


If you want the file to remain unlocked even if it is closed 
abnormally, set the FBSDLK mask in the l-word FOP field of the FAB; 
if you do not set the FBSDLK mask, the operating system locks the file 
if it is closed abnormally. 


Magtape Block Size 


If you are creating a magtape file, specify the block size (in 
characters) for the file in the l-word BLS field of the FAB. If you 
specify 0, RMS-11 uses the default block size for the device. If you 
specify a nonzero value, it must be in the range 18 through 8192. 


Magtape Positioning 


You can position a magtape file on its magtape. To position the file 
at the beginning of the magtape (overwriting all files on the tape), 
set the FBSRWO mask in the l-word FOP field of the FAB. To position 
the file at the end of the last-closed file (overwriting any following 
files), set the FBSPOS mask in the l-word FOP field of the FAB. If 
you set neither of these masks, the CREATE operation positions the 
file at the end of the last file on the magtape (overwriting nothing). 


Rewinding Magtape on Close 


If you want the magtape rewound when the created file is closed, set 
the FBSRWC mask in the l-word FOP field of the FAB. If you do not set 
this mask, the magtape will not be rewound on close unless you set the 
FBSRWC mask for the CLOSE operation. Note, however, that if you set 
the FBSRWC mask for the CREATE operation, the magtape will be rewound 
even if you do not set the FBSRWC mask for the CLOSE Operation. 
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Single-Area Unlocated File 
If you want the created file to have only one area, and if you do not 
want to place the area at a specific location on disk, then you supply 
no ALL blocks for the CREATE operation, but rather specify the 
following file attributes in FAB fields (as described in sections 
below): 

e File allocation size 

e Default file extension size 


e File bucket size 


e File contiguity 


Multiarea or Located File 


If you want to place the created file at a specific location on disk, 
or if you want a created indexed file to have more than one area, then 
you supply ALL blocks for the CREATE operation and you specify the 
following area attributes in ALL block fields (as described in 
sections below): 


e Area allocation size 

e Default area extension size 
@ Area bucket size 

@ Area contiguity 

@e Area alignment 

e Area location 


Specify the area number for each area in the l-byte AID field of the 
ALL block for the area. 


Sequential and relative files are permitted to have only a_ single 
area: area 0. Thus, for these files, the information in the (single) 
ALL block describes the file as a whole, overriding any corresponding 
information in the FAB. 


Similarly, block-accessed indexed files are treated without regard for 
their internal (logical) structure. In this case, only a single ALL 
block is permitted, and its contents describe the file as a whole, 
overriding any corresponding information in the FAB. 


Symmetric treatment of ALL blocks by the OPEN operation facilitates 
block-access COPY operations, which are independent of file 
organization. 


Allocation Size 


For a single-area unlocated file, specify the file allocation size (in 
blocks) in the 2-word ALQ field of the FAB. For a multiarea or 
located file, specify the area allocation size (in blocks) in the 
2-word ALQ field of the ALL block for each area. 
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Default Extension Size 


For a single-area unlocated file, specify the default extension size 
(in blocks) for the file in the l-word DEQ field of the FAB. For a 
multiarea or located file, specify the default extension size (in 
blocks) for each area in the l-word DEQ field of the ALL block for the 
area. 


Bucket Size (Relative or Indexed File) 


For a single-area unlocated file, specify the bucket size (in blocks) 
for the file in the l-byte BKS field of the FAB. For a multiarea or 
located file, specify the bucket size (in blocks) for each area in the 
l-byte BKZ field of the ALL block for the area. 


The Largest allowed bucket size is 32 blocks; the smallest is 0. If 
you specify a bucket size of 0, the CREATE operation uses 1-block 
buckets for the file or area. 


Area Location 


If you want to place an area at a particular location on disk, specify 
an alignment mask in the l-byte ALN field of the ALL block for the 
area. Logical block alignment places the area at a specified logical 
block; virtual block alignment (not allowed for area 0) places the 
area near a specified virtual block. If you specify no alignment 
mask, the CREATE operation places the area at any convenient location. 
The symbols for alignment masks are: 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


Specify the number of the logical block or virtual block in the 2-word 
LOC field of the ALL block for the area. 


If you do not want the file to be created unless the specified area 
location is available, set the XBSHRD mask in the 1l-byte AOP field of 
the ALL block for the area. If you do not set this mask, the CREATE 
operation creates the file even if it must place the area at an 
alternate location. Note that hard location at a virtual block 
location is illegal. 


The CREATE operation creates areas by extending the file if either of 
the following is true: ‘ ; 


e You specify placement for areas other than area 0 (in. which 
case the CREATE operation ignores the FBSCTG mask). 


e You specify contiguity in one or more ALL blocks, but not in 
the FAB for the file. 


Otherwise the CREATE operation creates the entire file as a single 
operation, and, if you specified contiguity in the FAB, creates the 
entire file as a single contiguous extent. 
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Contiguity 


If you want a file to be contiguous, set the FBSCTG mask in the l-word 
FOP field of the FAB and (for a multiarea file) do not specify disk 
location for any area except (optionally) area 0; if the CREATE 
operation . cannot create a contiguous file, it returns an error 
completion; if you do not set this mask, the CREATE operation does 
not attempt to create a contiguous file. 


If you want an area of a multiarea or located file to be contiguous, 
set the xXBSCTG mask in the l-byte AOP field of the ALL block for the 
area. If you set this mask and the CREATE operation cannot create a 
contiguous area, it returns an error completion; if you do not set 
this mask, the CREATE operation does not attempt to create a 
contiguous area. 


Indexes 


If you specify indexed file organization (FBSIDX value in the ORG 
field), you must supply at least one KEY block for the CREATE 
operation, unless you are using block access (in which case, any KEY 
blocks are ignored). Each KEY block you supply defines one index for 
the created file. 


Specify the reference number for each index in the l-byte REF field of 
the KEY block for the index. Specify 0 for the primary index, 1 for 
the first alternate index, and so forth. Chain KEY blocks so that the 
reference numbers are in consecutive order, and so that there are no 
intervening XABs of other types (ALL, DAT, PRO, or SUM blocks). 


Key Name 


If you want to define a key name for the index, place the key name 
string in a 32-character buffer. Specify the address of this buffer 
in the l-word KNM field of the KEY block for the index. If you 
specify 0 in the KNM field, the index has no key name. 


Index Key Data Type 


Specify a key data type code in the l-byte DTP field of the KEY block 
for each index. The symbols for key data type codes are: 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


Key Segments 


Specify the size and position of each key segment in the 8-byte SIZ 
field of the KEY block and the 8-word POS field of the KEY block for 
the index. (Only a string key can have more than one segment.) 
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The first byte of the SIZ field is for the size (in bytes) of the 
first key segment, the second byte is for the second segment, and so 
forth. If the key is to have fewer than eight segments, specify 0 in 
the remaining bytes of the SIZ field. (The CREATE operation does not 
check segment sizes after the first 0 it encounters in the SIZ field.) 


The first word of the POS field is for the position of the first key 
segment, the second word is for the second segment, and so forth. If 
the key has fewer than eight segments, the CREATE operation ignores 
the remaining words of the POS field. (The first position in a record 
is position 0.) 


Key Changes 


For an alternate index, if you want to allow the key to change during 
update operations, set the XBS$CHG mask in the l-byte FLG field of the 
KEY block and the XBSDUP mask in the l-byte FLG field of the KEY block 
for the index; if you do not set these masks, RMS-11 returns an error 
if a program attempts to change the value of a record key during 
updating. 


Key Duplications 


If you want to allow duplicate keys in an index, set the XBSDUP mask 
in the l-byte FLG field of the KEY block for the index. If you do not 
set this mask, RMS-11 returns an error if a program attempts to insert 
or update a record that would create a duplicate record key. Note 
that the XBSDUP mask must be set if record keys in the index are to be 
changeable during update. 


Null Keys 

If you want to omit null keys from an alternate index, set the XBSNUL 
mask in the l-byte FLG field of the KEY block for the index, and (for 
a string key) specify the null character for the key in the l-byte NUL 
field of the KEY block (the null value for a nonstring key is 0). 

If you do not set the XBSNUL mask, all keys are included in the index; 
if you set the XBSNUL mask, a nonstring key with a 0 value or a string 
key with an all-null value will not appear in that alternate index. 
Index Areas 


Specify areas for the data records and for the levels of the index: 


e The area for data records in the 1l-byte DAN field of the KEY 
block 


e The area for the lowest index level in the 1l-byte LAN field of 
the KEY block 


e The area for higher index levels in the l-byte IAN field of 
the KEY block 


Note that the bucket sizes of the LAN and IAN areas of a given index 
must be identical. 
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Bucket Fill Numbers 


Bucket fill numbers guide the PUT and UPDATE operations in deciding 
how many records to place in each bucket. A bucket fill number of 0 
is usually appropriate, and specifies that buckets should be filled 
completely. 


A nonzero bucket fill number specifies the number of bytes that should 
be filled in each bucket. If the specified bucket fill number is less 
than half the bucket size, it is rounded up to half the bucket size; 
if the specified number is more than the bucket size, it is rounded 
down to the bucket size. 


‘Specify the fill numbers for data buckets and index buckets: the fill 
number for data buckets in the l-word DFL field of the KEY block, and 
the fill number for index buckets in the l-word IFL field of the KEY 
block. 


Longest Record Length 


If you specify block access for the created file, and you plan to copy 
an existing file into the new file, you can specify the length of the 
longest record in the new file in the l-word LRL field of the FAB. 


RETURNED VALUES 


Internal File Identifier 


The CREATE operation writes an internal file identifier in the 1l-word 
IFI field of the FAB. (The CLOSE operation clears the internal file 
identifier.) 


The CLOSE, CONNECT, DISPLAY, and EXTEND operations read the internal 
file identifier; do not alter the IFI field while the file is open. 


Device Characteristics 


The CREATE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


@ Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the l-byte DEV field of the FAB is also set); RMS-1ll 
treats a printer or terminal as a unit-record device. 


@ Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB) ; RMS-11 treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


ANSI-format magtape (indicated by the set FBSSOD mask in the 
l-byte DEV field of the FAB). 
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Device, Directory, and File Identifiers 


If you supply a NAM block, the CREATE operation writes a device 
identifier in the. 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block, and a file 
identifier in the 3-word FID field of the NAM block. 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the CREATE operation writes the file 
specification for the created file in this buffer, and writes the 
length (in bytes) of the specification string in the l-byte ESL field 
of the NAM block. 


File Specification Characteristics 


The CREATE operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Wildcarding 


The CREATE operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block; this shows that no wildcard context exists after the 
CREATE operation. It also clears the l-byte RSL field of the NAM 
block to show that no resultant string was returned. 


Extension Sizes 


The CREATE operation returns the size (in blocks) of each allocation 
it makes. If you created only area 0 using FAB fields, the CREATE 
operation writes the size of the allocation in the 2-word ALQ field of 
the FAB. I£ you created areas using ALL blocks, the CREATE operation 
writes the size of each area allocation in the 2-word ALQ field of the 


ALL block for the area. 
Completion Status and Value 
The CREATE operation returns completion status in the l-word STS field 


of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
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CHECKLISTS 


Table 5-5 lists control block fields that are input to the CREATE 
operation. Table 5-6 lists control block fields that are output by 
the CREATE operation. 


Table 5-5: CREATE Input Fields 
a 


Block Field Description 


ee 


ALL AID Area number 
ALL ALN Initial area alignment request 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


ALL ALQ Initial area allocation request size (blocks) 
ALL AOP Area option mask 


XBSCTG Contiguous area request 
XBSHRD Area hard location request 


ALL BRKZ Area bucket size (blocks) 

ALL DEQ Area default extension size (blocks) 

ALL LOC Initial area location request 

ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB ALQ Initial file allocation request size (blocks) 
FAB BKS File bucket size (blocks) 

FAB BLS Magtape block size (characters) 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 

FAB DEQ Permanent file default extension size (blocks) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FAC Requested access mask 


FBSDEL Request find/get/delete access 
FBSGET Request find/get access 

FBSPUT Request put access 

FBSREA Request block read access 

FBSTRN Request find/get/truncate access 
FBSUPD Request find/get/update access 
FBSWRT Request block write access 


FAB FNA File string address 
FAB FNS File string size (bytes) 
FAB FOP File processing option mask 


’ FBSCTG Contiguous file request 
FBSDEW Defer writing 
FBSDLK No file locking on abnormal close 
FBSFID Use information in NAM block 
FBSMKD Mark file for deletion 
FBSPOS Position magtape after last-closed file 
FBSRWC Rewind magtape after closing file 
FBSRWO Rewind magtape before creating file 
FBSSUP Supersede existing file 
FBSTMD Temporary file, mark for deletion 
FBSTMP Temporary file 


(Continued on next page) 
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Table 5-5 (Cont.): CREATE Input Fields 


Block Field Description 


FAB FSZ Fixed control area size for VFC records (bytes) 
FAB LCH Logical channel number 

FAB LRL Longest record length 

FAB MRN Maximum record number 

FAB MRS Maximum record size (bytes) 

FAB NAM NAM block address 

FAB ORG File organization code 


FBSIDX Indexed file organization 
FBSREL Relative file organization 
FBSSEQ Sequential file organization 


FAB RAT Record handling mask 
FBSBLK Blocked records 
FBSCR Add CRLF to print record (LF-record-CR) 
FBSFTN FORTRAN-style carriage-control character in 
record 


FBSPRN VFC print record handling 
FAB REM Record format code 


FBSFIX Fixed-length record format 
FBSSTM Stream record format 

FBSUDF Undefined record format 
FBSVAR Variable-length record format 
FBSVEFC VFC record format 


FAB RTV Retrieval pointer count 
FAB SHR Shared access mask 


FBSGET Share find/get access 
FBSNIL No access sharing 
FBSWRI Share find/get/put/update/delete access 


EBSUPI Share any access (user-provided interlock) 
FAB XAB XAB address 
KEY DAN Data area number 
KEY DFL Data bucket fill factor 
KEY DTP Key data type code 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


KEY FLG Index option mask 
XBSDUP Duplicate record keys allowed 


XBSCHG Record key changes allowed on update 
XBSNUL Null record keys not indexed 


KEY IAN Higher level index area number 
KEY IFL Index bucket fill factor 

KEY KNM Key name buffer address 

KEY LAN Lowest index level area number 


(Continued on next page) 
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Table 5-5 (Cont.): CREATE Input Fields 


a en 


Block Field Description 


i 


KEY NUL Null key character 

KEY NXT Next XAB address 

KEY POS Key segment positions 

KEY REF Index reference number 

KEY SIZ Key segment sizes (bytes) 

NAM ESA Expanded string buffer address 
NAM DID Directory identifier 

NAM DVI Device identifier. 

NAM ESS Expanded string buffer size (bytes) 
PRO NXT Next XAB address 

PRO PRO File protection code 

SUM NXT Next XAB address 


Table 5-6: CREATE Output Fields 


a 


Block Field Description 


a a 


ALL ALQ Initial area allocation size (blocks) 
FAB ALQ Initial file allocation size (blocks) 
FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB IFI Internal file identifier 

FAB sts Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
NAM FID File identifier 

NAM FNB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established (cleared) 


NAM RSL Resultant string length (bytes) (cleared) 
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5.4 S$DELETE MACRO 


The SDELETE macro calls the DELETE operation routine to remove a 
record from a relative or indexed file. The target of the DELETE 
operation is the current record. The current record must be locked; 
it was automatically locked when the current-record context was set, 
but you must not have unlocked it with a FREE operation. 


If the stream has no current-record context, or if the current record 
is not locked, the DELETE operation returns an error completion. 


FORMAT 
The format for the SDELETE is: 
SDELETE rabaddr{[, [erraddr] [,sucaddr] ] 


where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the DELETE operation. 
OPTIONS 


Internal Stream Identifier 


The DELETE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Fast Deletion (Indexed File) 


If the file is an indexed file, and if its alternate indexes allow 
duplicate keys, then you can speed up the DELETE operation by using 
the fast-deletion procedure. However, this procedure is faster 
because it deletes only those alternate index pointers that it must; 
future retrieval operations may be slowed by the presence of undeleted 
alternate index pointers. ; 
To use the fast-deletion procedure with the DELETE operation, set the 
RBSFDL mask in the 1l-word ROP field of the RAB. If you do not set 
this mask, the DELETE operation does not use the fast-deletion 
procedure. 


Asynchronous Operation 


If you want to execute the DELETE operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the DELETE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 
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STREAM CONTEXT 


The current-record context after a DELETE operation is undefined; the 
next-record context is unchanged. 


RETURNED VALUES 


Completion Status and Value 
The DELETE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 
Table 5-7 lists control block fields that are input to the DELETE 
operation. Table 5-8 lists control block fields that are output by 
the DELETE operation. 
Table 5-7: DELETE Input Fields 
Block Field Description 
RAB ISI Internal stream identifier 


RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSEDL Fast deletion 


Table 5-8: DELETE Output Fields 


Block Field Description 


RAB sts Completion status code 
RAB STV Completion status value 
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5.5 SDISCONNECT MACRO 
The SDISCONNECT macro calls the DISCONNECT operation routine to 
terminate a stream and disconnect it, releasing the internal resources 
it was using. The stream context is lost; you cannot reestablish the 
same stream context by reconnecting the stream with the CONNECT 
operation. 
FORMAT 
The format for the SDISCONNECT is: 
SDISCONNECT rabaddr[, [erraddr][,sucaddr] ] 

where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the DISCONNECT operation. 
OPTIONS 


Internal Stream Identifier 

The DISCONNECT operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the DISCONNECT operation asynchronously, set 
the RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the DISCONNECT operation executes synchronously. (Your 
program must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 

STREAM CONTEXT 

The DISCONNECT operation terminates the stream; therefore there is no 
stream context after the DISCONNECT operation. 


RETURNED VALUES 


Internal Stream Identifier (Cleared) 


The DISCONNECT operation clears the internal stream identifier from 
the l-word ISI field of the RAB. 


Completion Status and Value 


The DISCONNECT operation returns completion status in the 1l-word STS 
field of the RAB and returns a completion value in the l-word STV 
field of the RAB. Appendix A lists completion status symbols and 
values. 
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CHECKLISTS 


Table 5-9 lists control block fields that are input to the DISCONNECT 
operation. Table 5-10 lists control block fields that are output by 
the DISCONNECT operation. 


Table 5-9: DISCONNECT Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-10: DISCONNECT Output Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB STs Completion status code 
RAB STV Completion status value 
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5.6 SDISPLAY MACRO 


The SDISPLAY macro calls the DISPLAY operation routine to write values 
into control block fields. The DISPLAY operation does not alter the 
file in any way. 


When you use the OPEN operation to open a file, you might not know how 
many areas or how many indexes the file has. If, however, you supply 
a SUM block for the OPEN operation, the OPEN operation writes the 
number of areas and number of keys (indexes) in its fields. You can 
then supply ALL blocks and KEY blocks so that the DISPLAY operation 
can fill their fields with values describing the file areas and 
indexes. 


FORMAT 
The format for the SDISPLAY is: 
SDISPLAY fabaddr[, [erraddr] [,sucaddr] } 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the DISPLAY operation. 


If the file is an indexed file, for each ALL block that you supply, 
the DISPLAY operation fills its fields with values describing the 
corresponding area (if any) of the file. You need not supply an ALL 
block for every area of the file. Note that if the file was opened 
for block access, no information is returned in ALL blocks. 


For each KEY block that you supply, the DISPLAY operation fills its 
fields with values describing the corresponding index (if any) for the 
file. You need not supply a KEY block for every index of the file. 
Note that if the file was opened for block access, no information is 
returned in KEY blocks. 


If you supply a PRO block for a disk file, the DISPLAY operation fills 
its fields with values showing the owner and protection for the file. 


If you supply a DAT block for a disk file, the DISPLAY operation fills 
its fields with values showing the creation date, expiration date, 
revision date, and revision number for the file. 


If you supply a SUM block for a relative or indexed file, the DISPLAY 
operation fills its fields with values showing the number of areas and 
indexes for the file, and with its prologue version number. (If you 
are opening the file for block access, the DISPLAY operation returns 
the number of areas and number of keys as 0, and does not return the 
prologue version number.) 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the DISPLAY 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NxT field of the last 
XAB. 
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All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the 1-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


Internal File Identifier 


The DISPLAY operation reads the internal file identifier from the 
l-word IFI field of the FAB. This is the value that was written when 
the file was opened by the CREATE or OPEN operation. 


Key Name Buffer 


If you want the key name string for an index returned to a buffer, 
Supply a KEY block for the index; specify the address of a 32-byte 
buffer in the l-word KNM field of the KEY block. If you do not supply 
a KEY block for an index, or if you specify 0 in its KNM field, the 
DISPLAY operation does not return the key name string. 


STREAM CONTEXT 


The DISPLAY operation does not affect stream context. 
RETURNED VALUES 


Area Descriptions 


For each ALL block that you supply, the DISPLAY operation writes a 
description in its fields of the corresponding area of the file. Area 
0 is described in the ALL block containing 0 in its AID field; area l 
is described in the ALL block containing 1 in its AID field; and so 
forth. 


The DISPLAY operation writes three sizes for a file area: the size 
(in blocks) of the unused portion of the area in the 2-word ALQ field 
of the ALL block, the default area extension size (in blocks) in the 
l-word DEQ field of the ALL block, and the area bucket size (in 
blocks) in the l-byte BKZ field of the ALL block. 


The DISPLAY operation clears the l-byte AOP field of the ALL block and 
the l-byte ALN field of the ALL block. 


Key Descriptions 


For each KEY block that you supply, the DISPLAY operation writes a 
description in its fields of the corresponding index of the file. The 
primary index is described in the KEY block containing 0 in its REF 
field; the first alternate index is described in the KEY block 
containing 1 in its REF field; and so forth. 
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The DISPLAY operation writes the key data type code in the l-byte DTP 
field of the KEY block. The symbols for key data type codes are: 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


The DISPLAY operation writes key segment information for the index: 
the number of key segments in the l-byte NSG field of the KEY block, 
and the total key size (sum of segments, in bytes) in the 1l-byte TKS 
field of the KEY block. 


The DISPLAY operation writes the sizes of key segments in the 8-byte 
SIZ field of the KEY block. The size (in bytes) of the first key 
segment is in the first byte of the SIZ field, the size of the second 
segment is in the second byte of the SIZ field, and so forth. If the 
key has fewer than eight segments, the first byte containing 0 
indicates the number of key segments. 


The DISPLAY operation writes the positions of key segments in the 
8-word POS field of the KEY block. The position (leftmost position is 
0) of the first key segment is in the first word of the POS field, the 
position of the second segment is in the second word of the POS field, 
and so forth. If the key has fewer than eight segments, the remaining 
words of the POS field contain unpredictable values. 


The DISPLAY operation writes a key-characteristics mask in the 1l1-byte 
FLG field of the KEY block. The symbols for key-characteristics masks 
are? 


XBSCHG Record key changes allowed on update 
XBSDUP Duplicate record keys allowed 

XBSINI No entries yet made in index 

XBSNUL Null record keys not indexed 


The DISPLAY operation writes the null-key character in the l-byte NUL 
field of the KEY block. This character is meaningful only if the 
XBSNUL mask in the l-byte FLG field of the KEY block is set and the 
DISPLAY operation returns the XBSSTG code in the l-byte DTP field of 
the KEY block (indicating a string key). 


The DISPLAY operation writes area numbers for the index: the area for 
the data level in the l-byte DAN field of the KEY block, the area for 
the lowest index level in the l-byte LAN field of the KEY block, and 
the area for higher index levels in the l-byte IAN field of the KEY 
block. 


The DISPLAY operation writes bucket fill numbers for the index areas: 
the fill number for the data area in the l-word DFL field of the KEY 
block, and the fill number for the index areas in the l-word IFL field 
of the KEY block. 


The DISPLAY operation writes bucket sizes for index areas: the data 
area bucket size (in blocks) in the l-byte DBS field of the KEY block, 
and the index area bucket size {in blocks) in the l-byte IBS field of 
the KEY block. 


The DISPLAY operation writes virtual block numbers for the index 
areas: the virtual block number for the first data bucket in the 
2-word DVB field of the KEY block, and the virtual block number of the 
root index bucket in the 2-word RVB field of the KEY block. 
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The DISPLAY operation writes the number of levels in the index (not 
including the data level) in the 1l-~byte LVL field of the KEY block. 


The DISPLAY operation writes the minimum size (in bytes) of a record 
that contains the key for the index in the l-word MRL field of the KEY 
block. 


File Owner and Protection (Disk File) 


If the file is a disk file, and if you supply a PRO block, the DISPLAY 
operation writes the project (or group) portion of the file owner code 
in the l-word PRJ field of the PRO block, the programmer (or member) 
portion of the file owner code in the l-word PRG field of the PRO 
block, and the file protection code in the l-word PRO field of the PRO 
block. 


File Dates 


If you supply a DAT block for a disk file, the DISPLAY operation 
writes four values in its fields: the creation date in the 4-word CDT 
field of the DAT block, the expiration date in the 4-word EDT field of 
the DAT block, the revision date in the 4-word RDT field of the DAT 
block, and the revision number (number of times the file has been 
write-accessed and then closed) in the l-word RVN field of the DAT 
block. 


File Summary Information 


If you supply a SUM block, the DISPLAY operation writes three values 
in its fields: the number of file areas in the l-byte NOA field of 
the SUM block, the number of file indexes in the 1l-byte NOK field of 
the SUM block, and the prologue version number (for a relative or 
indexed file) in the l-word PVN field of the SUM block. 


Completion Status and Value 


The DISPLAY operation returns completion status in the 1l-word STS 
field of the FAB and returns a completion value in the l-word STV 
field of the FAB. Appendix A lists completion status symbols = and 
values. 


CHECKLISTS 


Table 5-11 lists control block fields that are input to the DISPLAY 
operation. Table 5-12 lists control block fields that are output by 
the DISPLAY operation. 


Block Field 


ALL 
ALL 
DAT 
FAB 
FAB 
KEY 
KEY 
KEY 
PRO 
SUM 


Block Field 


ALL 
ALL 
ALL 


ALL 
ALL 
DAT 
DAT 
DAT 
DAT 
FAB 
FAB 
KEY 
KEY 
KEY 
KEY 


KEY 
KEY 


AID 
NXT 
NXT 
IFI 
XAB 
NXT 
KNM 
REF 
NXT 
NXT 


ALN 
ALQ 
AOP 


BRZ 
DEQ 
CDT 
EDT 
RDT 
RVN 
sts 
STV 
DAN 
DBS 
DFL 
DTP 


DVB 
FLG 
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Table 5-11: DISPLAY Input Fields 


Description 


Area number 

Next XAB address 

Next XAB address 
Internal file identifier 
XAB address 

Next XAB address 

Key name buffer address 
Index reference number 
Next XAB address 

Next XAB address 


Table 5-12: DISPLAY Output Fields 


Description 


Area alignment mask (cleared) 
Unused area allocation size (blocks) 
Area option mask 


XBSCTG Contiguous area (cleared) 
XBSHRD Hard area location (cleared) 


Area bucket size (blocks) 

Area default extension size (blocks) 
File creation date 

File expiration date 

File revision date 

File revision number 
Completion status code 
Completion status value 

Data area number 

Data area bucket size (blocks) 
Data bucket fill factor 

Key data type code 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


First data bucket virtual block number 
Index option mask 


XBSCHG Record key changes allowed on update 
XBSDUP Duplicate record keys allowed 
XBSINI No entries yet made in index 
XBSNUL Null record keys not indexed 


(Continued on next page) 
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Table 5-12 (Cont.): DISPLAY Output Fields 


Block Field Description 


KEY IAN Higher level index area number 

KEY IBS Index area bucket size (blocks) 

KEY IFL Index bucket fill factor 

KEY LAN Lowest index level area number 

KEY LVL Number of index levels (not including data level) 
KEY MRL Minimum length of record containing key (bytes) 
KEY NSG Key segment count 

KEY NUL Null key character 

KEY POS Key segment positions 

KEY RVB Root index bucket virtual block number 

KEY SIZ Key segment sizes (bytes) 

KEY TKS Total key size (sum of key segment sizes) (bytes) 
PRO PRG Programmer or member portion of file owner code 
PRO PRJ Project or group portion of file owner code 

PRO PRO File protection code 

SUM NOA Number of areas 

SUM NOK Number of indexes 

SUM PVN Prologue version number 
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5.7 SENTER MACRO 
The SENTER macro calls the ENTER operation routine to insert a file 
name into a directory file. 
FORMAT 
The format for the SENTER is: 
SENTER fabaddr[,[erraddr] [,sucaddr] ] 
where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 
You must supply a FAB for the ENTER operation. 
You must supply a NAM block for the ENTER operation. 


To supply a NAM block for the ENTER operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the ENTER 
operation, specify the address of the first XAB in the 1l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NxT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 

All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


File Specification 

The ENTER operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-11 defaults (which contribute 
elements not present in either the file string or the default string). 
RMS-11 defaults are: 

@® Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 

Directory -- The current directory for the task. 


Name, type, version -- Defaulted to null. 
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The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the 1l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the ENTER 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
ENTER operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the ENTER operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the ENTER operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


You must provide a NAM block for the ENTER operation, and must provide 
a valid file identifier in the 3-word FID field of the NAM block. 
This identifier specifies the file for which the entry (name, type, 
and version) will be created in the target directory. 


Expanded String Buffer 


If you want the ENTER operation to return the expanded string for the 
created file, provide a buffer for the string. Specify the address of 
the expanded string buffer in the 1-word ESA field of the NAM _ block. 
Specify the size (in bytes) of the expanded string buffer in the 
l-byte ESS field of the NAM block; if you specify 0 in the ESS field, 
the ENTER operation does not return the expanded string. 


Private Buffer Pool 


If you want the ENTER operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its’ size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the ENTER 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the ENTER operation in the l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 
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RETURNED VALUES 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the ENTER operation writes the file 
specification for the target file in this buffer, and writes the 
length (in bytes) of the specification string in the l-byte ESL field 
of the NAM block. 


Device Characteristics 


The ENTER operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


® Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1-byte DEV field of the FAB); RMS-11l treats a disk, 
DECtape, or DECTAPE II as a disk device. 


e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


e Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS—11l treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


@ ANSI-format magtape (indicated by the set FBSSQD mask in _ the 
l-byte DEV field of the FAB). 


Device and Directory Identifiers 


The ENTER operation returns the device identifier for the target file 
in the 2-word DVI field of the NAM block and the directory identifier 
in the 3-word DID field of the NAM block. 


a 


File Specification Characteristics 


The ENTER operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


OPERATION MACRO DESCRIPTIONS 
SENTER MACRO 
Wildcarding 
The ENTER operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block and the l-byte RSL field of the NAM block; this shows 
that no wildcard context exists and that no resultant string was 
returned. 
Completion Status and Value 
The ENTER operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 
Table 5-13 lists control block fields that are input to the ENTER 
operation. Table 5-14 lists control block fields that are output by 
the ENTER operation. 

Table 5-13: ENTER Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB FOP File processing option mask 


FBSFID Use information in NAM block 


FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 

NAM ESS Expanded string buffer size (bytes) 
NAM FID File identifier . 

PRO NXT Next XAB address 

SUM NXT Next XAB address 
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Table 5-14: ENTER Output Fields 


Block Field Description 


FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB sts Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
NAM FNB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established (cleared) 


NAM RSL Resultant string length (bytes) (cleared) 


OPERATION MACRO DESCRIPTIONS 
SERASE MACRO 


5.8 S$ERASE MACRO 


The SERASE macro calls the ERASE operation routine to erase a file and 
delete its directory entry. Note that erasing a file marks the file 
for deletion, but does not necessarily erase the file immediately; 
the file is erased when it has no accessing programs. The allocation 
for the file is released for use in other files. 


FORMAT 
The format for the SERASE is: 
SERASE fabaddr[,[erraddr] [,sucaddr}] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler. for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the ERASE operation. 


If you supply a NAM block and specify wildcarding, the ERASE operation 
reads the address and length of the expanded string from NAM block 
fields; if you supply a NAM block and specify erase by NAM block, the 
ERASE operation reads NAM block fields to obtain identifiers for the 
target file. 


To supply a NAM block for the ERASE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the ERASE 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB, 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


File Specification (Nonwildcard ERASE Operation) 


The ERASE operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-11l defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS~11 defaults are: 


@ Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


e Directory -+ The current directory for the task. 
@e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the 1-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the ERASE 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
ERASE operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the ERASE operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the ERASE operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the . directory in the 
merged string. 


In the same circumstance, the ERASE operation reads the file 
identifier from the 3-word FID field of the NAM block; if this value 
is nonzero, the specified file overrides any directory, name, type, 
and version elements previously obtained, and the file is erased 
without removing any directory entry that may exist for it. 


Erase by Wildcard Specification 


You can use the ERASE operation in a wildcarding program loop. (The 
NBSWCH mask in the l-word FNB field of the NAM block will already have 
been set by an earlier PARSE operation.) 


If you set the FBSFID mask in the l-word FOP field of the FAB, the 
file found by a previous SEARCH operation and its directory entry are 
deleted, but all fields relevant to wildcard context are preserved 
(for possible subsequent SEARCH operations). 


If you clear the FBSFID mask in the l-word FOP field of the FAB, the 
ERASE operation first performs an implicit SEARCH operation. (The 
input and output fields for the SEARCH operation are not described 
here and are not included in the checklists at the end of this 
section.) 


If the SEARCH operation finds a file that matches the wildcard file 
specification, the ERASE operation erases its contents and deletes its 
directory entry; if not, the ERASE operation does not erase the file 
contents or delete its directory entry, but instead passes control 
block data from the SEARCH operation (in particular, the ERSNMF 
completion status code and the cleared NBSWCH mask in the l-word FNB 
field of the NAM block). 
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Expanded String Buffer 


If you erase a file by its file specification, and if you want the 
ERASE operation to return the expanded string for the erased file, 
provide a buffer for the string. Specify the address of the expanded 
string buffer in the l-word ESA field of the NAM block. Specify the 
size (in bytes) of the expanded string buffer in the l-byte ESS field 
of the NAM block; if you specify 0 in the ESS field, the ERASE 
operation does not return the expanded string. 


Private Buffer Pool 


If you want the ERASE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the 1l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the ERASE 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the ERASE operation in the l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


RETURNED VALUES 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the ERASE operation writes the expanded 
string for the erased file in the buffer, and writes the length (in 
bytes) of the string in the l-byte ESL field of the NAM block. 


Device, Directory, and File Identifiers 


If you supply a NAM block, the ERASE operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block (unless directory 
processing was bypassed due to use of the file identifier on input), 
and a file identifier in the 3-word FID field of the NAM block. 


Device Characteristics 


The ERASE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 


in the 1-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 
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Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-11 treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Wildcard Context 


A nonwildcard ERASE operation clears the NBSWCH mask in the l-word FNB 
field of the NAM block and the l-byte RSL field of the NAM block; 
this shows that no wildcarding is in progress and that no resultant 
string was returned. 


File Specification Characteristics 


The ERASE operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Completion Status and Value 

The ERASE operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-15 lists control block fields that are input to the ERASE 


operation. Table 5-16 lists control block fields that are output by 
the ERASE operation. 
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Table 5-15: ERASE Input Fields 


Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB FOP File processing option mask 


FBSFID Use information in NAM block 


FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 
NAM ESS Expanded string buffer size (bytes) 
NAM FID File identifier 

NAM FNB File specification mask 

PRO NXT Next XAB address 

SUM NXT Next XAB address 


NBSWCH Wildcard context established 


Table 5-16: ERASE Output Fields 


Block Field Description 


FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB sts Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 
NAM FID File identifier 


(Continued on next page) 


Block Field 


NAM 


NAM 


FNB 


RSL 
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(Cont.): ERASE Output Fields 


Description 


File specification mask 


NBSNOD 
NBSDEV 
NBSDIR 
NBSQUO 
NBSNAM 
NBSTYP 
NBSVER 
NBSWDI 
NBSWNA 
NBSWTY 
NBSWVE 


NBSWCH 


Node in file string or default string 
Device in file string or default string 
Directory in file string or default string 
Quoted string in file string or default 
string 

File name in file string or default string 
File type in file string or default string 
File version in file string or default 
string 

Wildcard directory in file string or 
default string 

Wildcard file name in file string or 
default string 

Wildcard file type in file string or 
default string 

Wildcard file version in file string or 
default string 

Wildcard context established 


Resultant string length (bytes) 
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5.9 SEXTEND MACRO 


The SEXTEND macro calls the EXTEND operation routine to extend the 
allocation for an open file. 


FORMAT 
The format for the SEXTEND is: 
SEXTEND fabaddr[,[ferraddr][,sucaddr] } 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the EXTEND operation. 


For each ALL block that you supply, the EXTEND operation extends’ the 
corresponding area as described in the ALL block. You need not supply 
an ALL block for an area that you do not want to extend, but each 
supplied ALL block must correspond to an area in the file; this means 
that you can supply ALL blocks for areas other than area 0 only for an 
indexed file opened for record access. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the EXTEND 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


Internal File Identifier 


The EXTEND operation reads the internal file identifier from the 
l-word IFI field of the FAB. This is the value written by the CREATE 
or OPEN operation that opened the file. 


Area 0 Extended by FAB 


If you supply no ALL blocks, specify the size (in blocks) of the 
extension in the 2-word ALQ field of the FAB. 


If you want the extension to be contiguous within itself (it will not 
necessarily be contiguous with the file), set the FBSCTG mask in the 
l-word FOP field of the FAB; if you do not set this mask, the 
extension is not necessarily contiguous within itself. 
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Areas Extended by ALL Blocks 


If you supply ALL blocks, the EXTEND operation ignores the ALQ field 
of the FAB, and extends each area specified in an ALL block. Specify 
each area to be extended by supplying an ALL block with the area 
number in the l-byte AID field of the ALL block. Specify the size of 
the extension (in blocks) for the area in the 2-word ALQ field of the 
ALL block. 


If you want the area extension to be contiguous within itself (it will 
not be contiguous with the previous area extent), set the XBSCTG mask 
in the l-byte AOP field of the ALL block. If you do not set this 
mask, the extension will not necessarily be contiguous within itself. 


If you want to place the extension at a specific location, specify an 
alignment mask in the 1-byte ALN field of the ALL block; if you 
specify 0, the EXTEND operation places the extension at any convenient 
location. The symbols for alignment masks are: 
XBSLBN Logical block alignment 

XBSVBN Virtual block alignment 


Specify the number of the logical block or virtual block in the 2-word 
Loc field of the ALL block. 


If you specify logical block alignment, and if you want the extension 
placed only at the location you specify, set the XBS$HRD mask in the 
l-byte AOP field of the ALL block. If you do not set this mask, the 
EXTEND operation selects an alternate location if the specified 
location is not available. If you do set this mask, the EXTEND 
operation returns an error completion if the specified location is not 
available. 


STREAM CONTEXT 


The EXTEND operation does not affect stream context. 


RETURNED VALUES 


Extension Sizes 


The EXTEND operation returns the size (in blocks) of each extension it 
makes. If you extended only area 0 using FAB fields, the EXTEND 
operation writes the size of the extension in the 2-word ALQ field of 
the FAB. If you extended areas using ALL blocks, the EXTEND operation 
writes the size of each area extension in the 2-word ALQ field of the 
ALL block for the area. 


Completion Status and Value 

The EXTEND operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-17 lists control block fields that are input to the EXTEND 


operation. Table 5-18 lists control block fields that are output by 
the EXTEND operation. ; 
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Block Field 


ALL 
ALL 


ALL 
ALL 


ALL 
ALL 
DAT 
FAB 
FAB 


FAB 
FAB 
KEY 
PRO 
KEY 
SUM 


Block Field 


ALL 
FAB 
FAB 
FAB 


AID 
ALN 


ALQ 
AOP 


LOC 
NXT 
NXT 
ALQ 
FOP 


IFI 
XAB 
NXT 
NXT 
REF 
NXT 


ALQ 


ALQ 


sTSs 
STV 


Table 5-17: EXTEND Input Fields 


Description 


Area number 
Area extension alignment request 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


Area allocation extension request size (blocks) 
Area option mask 


XBSCTG Contiguous area extension request 
XBSHRD Area extension hard location request 


Area extension location request 

Next XAB address 

Next XAB address 

File allocation extension request size (blocks) 
File processing option mask : 


FBSCTG Contiguous file extension request 


Internal file identifier 
XAB address 

Next XAB address 

Next XAB address 

Index reference number 
Next XAB address 


Table 5-18: EXTEND Output Fields 
Description 
Area allocation extension actual size (blocks) 
File allocation extension actual size (blocks) 


Completion status code 
Completion status value 
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5.10 SFIND MACRO (SEQUENTIAL ACCESS) 
The SFIND macro calls the FIND operation routine to transfer a record 
(or part of a _ record) from a file to an I/O buffer. The FIND 
operation transfers the entire record if the file is relative or 
indexed, or if it has blocked records; it may transfer only part of 
the record if the record spans block boundaries. The FIND operation 
does not transfer the record to a user buffer. 
The target of a sequential-access FIND operation is the next record 
(for an indexed file, the next record under the current index). 
FORMAT 
The format for the SFIND is: 

SFIND rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FIND operation. 


OPTIONS 


Internal Stream Identifier 


The FIND operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the FIND operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the FIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Sequential Access 


Specify the RBSSEQ code in the l-byte RAC field of the RAB. 


STREAM CONTEXT 


The current-record context after a sequential access FIND operation is 
the found record; the next-record context is the record following the 
found record (for an indexed file, the next record under the current 
index). Tf the FIND operation returns an error completion, the 
current-record context is undefined, and the next-record context is 
unchanged. 
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RETURNED VALUES 


RRN 
For a relative file or for a sequential disk file with fixed-length 
records, a sequential-access FIND operation returns’ the relative 


record number (RRN) for the found record in the 2-word BKT field of 
the RAB. 


RFA 


The FIND operation returns the record file address (RFA) for the found 
record in the 3-word RFA field of the RAB. 


Completion Status and Value 
The FIND operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-19 lists control block fields that are input to the FIND 
operation, Table 5-20 lists control block fields that are output by 
the FIND operation. 


Table 5-19: FIND (Sequential Access) Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB RAC Record access code 


RBSSEQ Sequential access 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-20: FIND (Sequential Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB RFA Record file address 

RAB STS Completion status code 

RAB STV Completion status value 
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5.11 $FIND MACRO (KEY ACCESS) 


The SFIND macro calls the FIND operation routine to transfer a record 
(or part of a record) from a sequential disk file (with fixed-length 
records), a relative file, or an indexed file to an I/O buffer. The 
FIND operation transfers the entire record if the file is relative or 
indexed, or if it has blocked records; it may transfer only part of 
the record if the record spans block boundaries. The FIND operation 
does not transfer the record to a user buffer. 


The target of a key-access FIND operation is the record having the 
specified key (under the specified match criterion). For a relative 
file or for a sequential disk file with fixed-length records, the key 
is a relative record number (RRN); for an indexed file, the key is an 
index key under the specified index. 
FORMAT 
The format for the SFIND is: 

SFIND rabaddr[,{erraddr][,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FIND operation. 


OPTIONS 


Internal Stream Identifier 

The FIND operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the FIND operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the FIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Key Access 


Specify the RBS$KEY code in the l-byte RAC field of the RAB. 


Key of Reference (Indexed File) 


Specify the key of reference in the l-byte KRF field of the RAB. The 
key of reference is the reference number (REF field of KEY block) for 
the index you want to use for the FIND operation. 
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Key 


Specify a buffer containing the key for the record to be found: 
specify the address of the key buffer in the l-word KBF field of the 
RAB, and specify the size of the key in the l-byte KSZ field of the 
RAB. 


For a relative file, or for a sequential file with fixed-length 
records, specify a 4-byte binary relative record number (RRN) as the 
key, and specify the key size as 0 or 4. 


For an indexed file, specify a key of the same type as the key for the 
current index,-.and specify a key size no greater than the key size for 
the current index. For a nonstring key, the specified key size must 
be the key size defined for the index (or, equivalently, 0); fora 
string key, if you specify a key size smaller than the key size for 
the index, the FIND operation searches for a record whose key begins 
with the specified partial key (under the specified key criterion). 


Key Criterion 


Specify a key-criterion mask in the l-word ROP field of the RAB. The 
symbols for key-criterion masks are: 


RBSKGE Greater-than-or-equal key criterion 
RBSKGT Greater-than key criterion 


If you specify the key-greater criterion, the FIND operation searches 
for the first record whose key is greater than the key you specify; 
if you specify the key-greater-or-equal criterion, the FIND operation 
searches for the first record whose key is greater than or equal to 
the key you specify; if you specify neither criterion, the FIND 
operation searches for a record whose key exactly matches the key you 
specify. (It is illegal to specify both criteria.) 


STREAM CONTEXT 
The current-record context after a key access FIND operation is the 
found record; the next-record context is unchanged. If the FIND 


operation returns an error completion, the current-record context is 
undefined, and the next-record context is unchanged. 


RETURNED VALUES 


RFA 


The FIND operation returns the record file address (RFA) for the found 
record in the 3-word RFA field of the RAB, 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, the FIND operation returns the RRN of the found record in the 
2-word BKT field of the RAB, 
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Completion Status and Value 


The FIND operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-21 lists control block fields that are input to the FIND 
operation. Table 5-22 lists control block fields that are output. by 
the FIND operation. 


Table 5-21: FIND (Key Access) Input Fields 


a a 


Block Field Description 


i 


RAB ISI Internal stream identifier 
RAB KBF Key buffer address 

RAB KRF Key of reference 

RAB KSZ Key size (bytes) 

RAB RAC Record access code 


RBS KEY Key access 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSKGE Greater-than-or-equal key criterion 
RBSKGT Greater-—than key criterion 


a 


Table 5-22: FIND (Key Access) Output Fields 


rR A 


Block Field Description 


wee eee 


RAB BKT Relative record number (RRN) 
RAB RFA Record file address 

RAB STS Completion status code 

RAB STV Completion status value 


i 
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5.12 SFIND MACRO (RFA ACCESS) 
The SFIND macro calls the FIND operation routine to transfer a record 
(or part of a record) from a file to an I/O buffer. The FIND 
Operation transfers the entire file if the file is relative or 
indexed, or if it has blocked records; it may transfer only part of 
the record if the record spans block boundaries. The FIND operation 
does not transfer the record to a user buffer. 
The target of an RFA-access FIND operation is the record having the 
record file address (RFA) you specify. 
FORMAT 
The format for the SFIND is: 

SFIND rabaddr[,[erraddr]} [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FIND operation. 
OPTIONS 


Internal Stream Identifier 

The FIND operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the FIND operation asynchronously, set the 
RBSASY mask in the l-word ROP field of the RAB; if you do not set 
this mask, the FIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


RFA Access 


Specify the RBSRFA code in the l-byte RAC field of the RAB. 


RFA 


Specify the RFA for the record to be found in the 3-word RFA field of 
the RAB. 


STREAM CONTEXT 


The current-record context after an RFA access FIND operation is the 
found record (for an indexed file, in the context of the primary 
index); the next-record context is unchanged. If the FIND operation 
returns an error completion, the current-record context is undefined, 
and the next-record context is unchanged. 
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RETURNED VALUES 


RRN 

For a relative file or for a sequential disk file with fixed-length 
records, the FIND operation returns the RRN of the found record in the 
2-word BKT field of the RAB. 

Completion Status and Value 

The FIND operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-23 lists control block fields that are input to the FIND 


operation. Table 5-24 lists control block fields that are output by 
the FIND operation. 


Table 5-23: FIND (RFA Access) Input Fields 


Block Field Description 
RAB ISI Internal stream identifier 
RAB RAC Record access code 
RBSRFA RFA access 


RAB RFA Record file address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-24: FIND (RFA Access) Output Fields 


Block Field Description 


RAB BKT Relative record number (RRN) 
RAB STs Completion status code 
RAB STV Completion status value 


OPERATION MACRO DESCRIPTIONS 
SFLUSH MACRO 
5.13 $FLUSH MACRO 
The SFLUSH macro calls the FLUSH operation routine to write any 
unwritten buffers for a stream. The FLUSH operation does not affect 
stream context, except that the current-record context is undefined 
for a following TRUNCATE or UPDATE operation. 
Note one special case: if a file was opened for deferred writing 
(FBSDFW set in the FOP field of the FAB for the CREATE or OPEN 
operation), and was not opened for write sharing (FBSWRI cleared in 
the SHR field of the FAB), then a buffer may be controlled by a 
different stream, and it will not be written by the FLUSH operation. 
FORMAT 
The format for the SFLUSH is: 

SFLUSH rabaddr[,[erraddr] [,sucaddr]]} 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FLUSH operation. 
OPTIONS 


Internal Stream Identifier 


The FLUSH operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the FLUSH operation asynchronously, set the 
RBSASY mask in the l-word ROP field of the RAB; if you do not set 
this mask, the FLUSH operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 
The FLUSH operation does not affect stream context, except that the 


current-record context is undefined for a following TRUNCATE or UPDATE 
operation. 


RETURNED VALUES 


Completion Status and Value 


The FLUSH operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
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CHECKLISTS 


Table 5-25 lists control block fields that are input to the FLUSH 
operation. Table 5-26 lists control block fields that are output by 
the FLUSH operation. 


Table 5-25: FLUSH Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-26: FLUSH Output Fields 


Block Field Description 


RAB STs Completion status code 
RAB STV Completion status value 
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5.14 S$FREE MACRO 

The SFREE macro calls the FREE operation routine to free a locked 
bucket for a stream. The FREE operation does not affect stream 


context, except that the current-record context is undefined for a 
following DELETE, TRUNCATE, or UPDATE operation. 


FORMAT 
The format for the SFREE is: 

$FREE rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the FREE operation. 
OPTIONS 


Internal Stream Identifier 


The FREE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the FREE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the FREE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 
The FREE operation does not affect stream context, except that the 


current-record context is undefined for a following DELETE, TRUNCATE, 
or UPDATE operation. 


RETURNED VALUES 


Completion Status and Value 


The FREE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-27 lists control block fields that are input to the FREE 
operation. Table 5-28 lists control block fields that are output by 
the FREE operation. 
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Table 5-27: FREE Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-28: FREE Output Fields 


Block Field Description 


RAB sts Completion status code 
RAB STV Completion status value 
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5.15 $GET MACRO (SEQUENTIAL ACCESS) 


The $GET macro calls the GET operation routine to transfer a record 
from a file to an I/O buffer and to a user buffer. 


The target of a sequential-access GET operation depends on whether the 
previous operation was a FIND operation: 


e If the previous operation was a successful FIND operation, the 
target of a sequential-access GET operation is the current 
record (or the first following record if the current record 
was deleted or its key changed in the interim). 

e If the previous operation was not a successful FIND operation, 
the target of a sequential-access. GET operation is the next 
record (for an indexed file, the next record under the current 
index). 

FORMAT 
The format for the SGET is: 

SGET rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the GET operation. 
OPTIONS 


Internal Stream Identifier 


The GET operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the GET operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the GET operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Sequential Access 


Specify the RBSSEQ code in the l-byte RAC field of the RAB. 


User Buffer 


Specify a user buffer for the GET operation. The GET operation copies 
the retrieved record to this buffer if you do not specify locate mode 
(see next section, Locate Mode); the GET operation may copy the 
retrieved record to this buffer even if you specify locate mode. 
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Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 


If the file is in VFC record format, specify the address of a buffer 
for the fixed-length portion of the record in the 1l-word RHB field of 
the RAB. 


Locate Mode 


If you want the GET operation to use locate mode (in which the record 
may not be transferred to the user buffer), set the RBSLOC mask in the 
l-word ROP field of the RAB; if you do not set this mask, the record 
is transferred to the user buffer. 


STREAM CONTEXT 


The current-record context after a sequential access GET operation is 
the retrieved record; the next-record context is the record following 
the retrieved record. 


If the GET operation returns an error completion, the current-record 
context is undefined, and the next-record context is unchanged. 


RETURNED VALUES 


Record 


The GET operation returns the address and size of the retrieved record 
in the 1l-word RBEF field of the RAB, and the size (in bytes) of the 
record in the l-word RSZ field of the RAB. 


If you did not specify locate mode for the GET operation, the record 
address returned in the RBF field is the address you specified in the 
UBF field; if you specified locate mode, the record address returned 
in the RBF field is either the address you specified in the UBF field, 
or the address of a location in an I/O buffer. 


If the file is in VFC format, the GET operation writes the 
fixed-length portion of the record in the buffer you specified in the 
RHB field of the RAB. , 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, a sequential-access GET operation returns the relative record 
number (RRN) for the retrieved record in the 2-word BKT field of the 
RAB. 


RFA 
The GET operation returns the record file address (RFA) for the 


retrieved record in the 3-word RFA field of the RAB. 
fe 
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Completion Status and Value 


The GET operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-29 lists control block fields that are input to the GET 
operation. Table 5-30 lists control block fields that are output by 
the GET operation. 


Table 5-29: GET (Sequential Access) Input Fields 
a es = es 
Block Field Description 
a st a Rn 


RAB ISI Internal stream identifier 
RAB RAC Record access code 


RBSSEQ Sequential access 


RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOC Locate mode 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 
es ve te 


Table 5-30: GET (Sequential Access) Output Fields 
Block Field Description 
Sc 


RAB BKT Relative record number (RRN) 
RAB RBF Record buffer address 

RAB RFA Record file address 

RAB RSZ Record size (bytes) 

RAB sts Completion status code 

RAB STV Completion status value 


re ee 
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5.16 S$GET MACRO (KEY ACCESS) 
The SGET macro calls the GET operation routine to transfer a record 
from a sequential disk file (with fixed-length records), a relative 
file, or an indexed file to an I/O buffer and to a user buffer. 
The target of a key-access GET operation is the record having the 
specified key (under the specified match criterion). For a relative 
file or for a sequential disk file with fixed-length records, the key 
is a relative record number (RRN); for an indexed file, the key is an 
index key under the specified index. 
FORMAT 
The format for the SGET is: 
SGET rabaddr[,{ferraddr] [,sucaddr] ] 

where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation, 


CONTROL BLOCKS 


You must supply a RAB for the GET operation. 
OPTIONS 


Internal Stream Identifier 


The GET operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the GET operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the GET operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Key Access 


Specify the RBSKEY code in the l-byte RAC field of the RAB. 


Key of Reference (Indexed File) 


Specify the key of reference in the l-byte KRF field of the RAB. The 
key of reference is the reference number (REF field of KEY block) for 
the index you want to use for the GET operation. 


Key 


Specify a buffer containing the key for the record to be retrieved: 
specify the address of the key buffer in the l-word KBF field of the 
RAB, and specify the size of the key in the l-byte KSZ field of the 
RAB. 
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For a relative file or for a sequential file with fixed-length 
records, specify a 4-byte binary relative record number (RRN) as the 
key, and specify the key size as 0 or 4. 


For an indexed file, specify a key of the same type as the key for the 
current index, and specify a key size no greater than the key size for 
the current index. For a nonstring key, the specified key size must 
be the key size defined for the index (or, equivalently, 0); for a 
string key, if you specify a key size smaller than the key size for 
the index, the GET operation searches for a record whose key begins 
with the specified partial key (under the specified key criterion). 


Key Criterion 


Specify a key-criterion mask in the l-word ROP field of the RAB. The 
symbols for key-criterion masks are: 


RBSKGE Greater-than-or-equal key criterion 
RBSKGT Greater-than key criterion 


If you specify the key-greater criterion, the GET operation searches 
for the first record whose key is greater than the key you specify; 
if you specify the key-greater-or-equal criterion, the GET operation 
searches for the first record whose key is greater than or equal to 
the key you specify; if you specify neither criterion, the GET 
operation searches for a record whose key exactly matches the key you 
specify. 


User Buffer 


Specify a user buffer for the GET operation. The GET operation copies 
the retrieved record to this buffer if you do not specify locate mode 
(see next section, Locate Mode); the GET operation may copy the 
retrieved record to this buffer even if you specify locate mode. 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the 1l-word 
USZ field of the RAB. 


If the file is in VFC record format, specify the address of a buffer 
for the fixed-length portion of the record in the l-word RHB field of 
the RAB. 


Locate Mode 


If you want the GET operation to use locate mode (in which the record 
May not be transferred to the user buffer), set the RBSLOC mask in the 
l-word ROP field of the RAB; if you do not set this mask, the record 
is transferred to the user buffer. 


STREAM CONTEXT 


The current-record context after a key access GET operation is the 
retrieved record; the next-record context is the record following the 
retrieved record. 


If the GET operation returns an error completion, the current-record 
context is undefined, and the next-record context is unchanged. 
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RETURNED VALUES 


Record 


The GET operation returns the address and size of the retrieved record 
in the l-word RBF field of the RAB, and the size (in bytes) of the 
record in the l-word RSZ field of the RAB. 


If you did not specify locate mode for the GET operation, the record 
address returned in the RBF field is the address you specified in the 
UBF field. If you specified locate mode, the record address returned 
in the RBF field is either the address you specified in the UBF field, 
or the address of a location in an I/O buffer. 


If the file is in VFC format, the GET operation writes the 
fixed-length portion of the record in the buffer you specified in the 
RHB field of the RAB. 

RRN 

For a relative file or for a sequential disk file with fixed-length 
records, a key-access GET operation returns the relative record number 
(RRN) for the retrieved record in the 2-word BKT field of the RAB. 

RFA 

The GET operation returns the record file address (RFA) for the 
retrieved record in the 3-word RFA field of the RAB. 

Completion Status and Value 

The GET operation returns completion status in the l-word STS field of 
the -RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-31 lists control block fields that are input to the GET 


operation. Table 5-32 lists control block fields that are output by 
the GET operation. 
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Block Field 


RAB 
RAB 
RAB 
RAB 
RAB 


RAB 


RAB 


RAB 
RAB 


Block Field 


RAB 
RAB 
RAB 
RAB 
RAB 
RAB 


ISI 
KBF 
KRF 
KSZ 
RAC 


RHB 
ROP 


UBF 
USZ 


BRKT 
RBF 
RFA 
RSZ 
STs 
STV 


Table 5-31: GET (Key Access) Input Fields 


Description 


Internal stream identifier 
Key buffer address 

Key of reference 

Key size (bytes) 

Record access code 


RBSKEY Key access 


VFC control buffer address 
Record processing option mask 


RBSASY Asynchronous operation 

RBSKGE Greater-than-or-equal key criterion 
RBSKGT Greater-than key criterion 

RBSLOC Locate mode 


User buffer address 
User buffer size (bytes) 


Table 5-32: GET (Key Access) Output Fields 


Description 


Relative record number (RRN) 
Record buffer address 

Record file address 

Record size (bytes) 
Completion status code 
Completion status value 
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5.17 SGET MACRO (RFA ACCESS) 


The SGET macro calls the GET operation routine to transfer a record 
from a file to an I/O buffer and to a user buffer. 


The target of an RFA-access GET operation is the record having the 
record file address (RFA) you specify. 
FORMAT 
The format for the SGET is: 

SGET rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 


You must supply a RAB for the GET operation. 
OPTIONS 


Internal Stream Identifier 


The GET operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the GET operation asynchronously, set the 
RBSASY mask in the l-word ROP field of the RAB; if you do not set 
this mask, the GET operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


RFA Access 


Specify the RBSRFA code in the l-byte RAC field of the RAB. 


RFA 


Specify the RFA for the record to be retrieved in the 3-word RFA field 
of the RAB. 


User Buffer 


Specify a user buffer for the GET operation. The GET operation copies 
the retrieved record to this buffer if you do not specify locate mode 
(see next section, Locate Mode); the GET operation may copy the 
retrieved record to this buffer even if you specify locate mode. 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 
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If the file is in VFC record format, specify the address of a buffer 
for the fixed-length portion of the record in the l-word RHB field of 
the RAB. 


Locate Mode 


If you want the GET operation to use locate mode (in which the record 
May not be transferred to the user buffer), set the RBSLOC mask in the 
l-word ROP field of the RAB; if you do not set this mask, the record 
is transferred to the user buffer. 


STREAM CONTEXT 


The current-record context after an RFA access GET operation is the 
retrieved record (for an indexed file, in the context of the primary 
index); the next-record context is the record following the retrieved 
record. If the GET operation returns an error completion, the 
current-record context is undefined, and the next-record context is 
unchanged. 


RETURNED VALUES 


Record 


The GET operation returns the address and size of the retrieved record 
in the 1l-word RBF field of the RAB, and the size (in bytes) of the 
record in the l-word RSZ field of the RAB. 


If you did not specify tocate mode for the GET operation, the record 
address returned in the RBF field is the address you specified in the 
UBF field. If you specified locate mode, the record address returned 
in the RBF field is either the address you specified in the UBF field, 
or the address of a location in an I/0 buffer: 


If the file is in VFC format, the GET operation writes the 
fixed-length portion of the record in the buffer you specified in the 
RHB field of. the RAB. 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, an RFA-access GET operation returns the relative record 
number (RRN) for the retrieved record in the 2-word BKT field of the 
RAB. 


Completion Status and Value 


The GET operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-33 lists control block fields that are input to the GET 
operation. Table 5-34 lists control block fields that are output by 
the GET operation. 
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Table 5-33: GET (RFA Access) Input Fields 


Sn 


Block Field Description 


gn nNOS Too 


RAB ISI Internal stream identifier 
RAB RAC Record access code 


RBSRFA RFA access 


RAB RFA Record file address 
RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOC Locate mode 


RAB UBE User buffer address 
RAB USZ User buffer size (bytes) 


i 


Table 5-34: GET (RFA Access) Output Fields 


A 


Block Field Description 


A 


RAB BKT Relative record number (RRN) 
RAB RBF Record buffer address 

RAB RSZ Record size (bytes) 

RAB STS Completion status code 

RAB STV Completion status value 


i es eS eee 
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5.18 SNXTVOL MACRO 


The SNXTVOL macro calls the NXTVOL operation routine to advance the 
context for a stream to the beginning of the next magtape volume. 


FORMAT 
The format for the SNXTVOL is: 

SNXTVOL rabaddr[,[{erraddr][,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the NXTVOL operation. 
OPTIONS 


Internal Stream Identifier 


The NXTVOL operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Asynchronous Operation 


If you want to execute the NXTVOL operation asynchronously, set the 
RBSASY mask in the 1-word ROP field of the RAB; if you do not set 
this mask, the NXTVOL operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


The NXTVOL operation destroys the current-record context; the 
next-record context after the NXTVOL operation is the first record of 
the new volume (or end-of-file, if there are no records on the new 
volume). 


RETURNED VALUES 


Completion Status and Value 


The NXTVOL operation returns completion status in the l-word STS field 
‘Of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-35 lists control block fields that are input to the NXTVOL 
operation, Table 5-36 lists control block fields that are output by 
the NXTVOL operation. 
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Table 5-35: NXTVOL Input Fields 
Block Field Description 
RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-36: NXTVOL Output Fields 


Block Field Description 


RAB sts Completion status code 
RAB STV Completion status value 
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5.19 SOPEN MACRO 


The SOPEN macro calis the OPEN operation routine to open a file. for 
processing by the calling task. 


FORMAT 
The format for the SOPEN is: 
SOPEN fabaddr[,ferraddr][,sucaddr] ] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the OPEN operation. 


If you supply a NAM block and specify open by NAM block, the OPEN 
Operation reads NAM block fields to obtain identifiers for the target 
file. 


To supply a NAM block for the OPEN operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


For each ALL block that you supply, the OPEN operation fills its 
fields with values describing the corresponding area (if any) of the 
file. You need not supply an ALL block for every area of the file. 
(If you are opening the file for block access, the OPEN operation 
writes information describing the file as a whole in the all block for 
area 0.) 


For each KEY block that you supply, the OPEN operation fills its 
fields with values describing the corresponding index (if any) for the 
file. You need not supply a KEY block for every index of the file. 
(If you are opening the file for block access, the OPEN operation does 
not write in KEY blocks.) 


If you supply a PRO block for a disk file, the OPEN operation fills 
its fields with values showing the owner and protection for the file. 


If you supply a DAT block for a disk file, the OPEN operation fills 
its fields with values - showing the creation date, expiration date, 
revision date, and revision number for the file. 


If you supply a SUM block for a relative or indexed file, the OPEN 
operation fills its fields with values showing the number of areas and 
indexes for the file, and with its prologue version number. (If you 
are opening the file for block access, the OPEN operation returns the 
number of areas and number of keys as 0, and does not return the 
prologue version number.) 


This information is especially useful if you do not know how many 
areas or keys an indexed file has when you open it. If you supply a 
SUM block for the OPEN operation, you can get the number of areas and 
number of indexes from its fields, and then supply the correct number 
of ALL blocks and KEY blocks for the DISPLAY operation. 
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To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the OPEN 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB,. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 


OPTIONS 


File Specification (Nonwildcard OPEN Operation) 


The OPEN operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-11 defaults (which contribute. 
elements not present in either the file string or the default string). 


RMS-11l defaults are: 


@ Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@ Directory -- The current directory for the task. 
@e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the 1l-byte FNS 
field of the FAB; if you specify 0O in the FNS field, the OPEN 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
OPEN operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the OPEN operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the OPEN operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


In the same circumstance, the OPEN operation reads the file identifier 
from the 3-word FID field of the NAM block; if this value is zero, 
the specified file overrides any directory, name, type, and version 
elements previously obtained. 
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Open with Wildcard Context 


If you want to open a file that. was found by a wildcard SEARCH 
operation (using the FAB and NAM block that the SEARCH operation 
used), set the FBSFID mask in the l-word FOP field of the FAB; this 
causes the OPEN operation to open the file without altering wildcard 
context. 


Expanded String Buffer 


If you want the OPEN operation to return the expanded string for the 
opened file, provide a buffer for the string. Specify the address of 
the expanded string buffer in the l-word ESA field of the NAM block 
and its size (in bytes) in the l-byte ESS field of the NAM block; if 
you specify 0 in the ESS field, the OPEN operation does not return the 
expanded string. 


Key Name Buffer 


If you want the key name string for an index returned to a buffer, 
supply a KEY block for the index. Specify the index reference number 
in the l-byte REF field of the KEY block, and specify the address of a 
32-byte buffer in the l-word KNM field of the KEY block. I£ you do 
not supply a KEY block for an index, or if you specify 0 in its KNM 
field, the OPEN operation does not return the key name string. 


While-Open Default Extension Sizes 


If you want to override the default extension size for the file while 
it is open, specify the while-open default file extension size (in 
blocks) in the l-word DEQ field of the FAB. If you specify 0, the 
OPEN operation does not establish a while-open default extension size 
for the file; instead, it uses the permanent default extension size. 


The while-open default extension size for a file remains in force 
while the file is open, but does not change the file extension size 
established when the file was created. 


Private Buffer Pool 


If you want the OPEN operation to use a private buffer pool instead of 
the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the OPEN 
operation uses the central buffer pool. 


The pool that the OPEN operation uses is also used by the DISPLAY and 
EXTEND operations, and by stream and record or block operations while 
the file is open. 


Logical Channel 


Specify the logical channel for the OPEN operation in the l1-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
QO. 
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The logical channel that the OPEN operation uses is also used by the 
DISPLAY and EXTEND operations, and by stream and record or block 
operations while the file is open. 


Retrieval Pointers 


Specify the number of retrieval pointers for the open file in _ the 
l-byte RTV field of the FAB. If you specify 0, the OPEN operation 
uses the operating system default; if you specify -1, the OPEN 
operation maps as much of the file as possible. 


Requested-Access 


Specify one or more requested-access masks in the l-byte FAC field of 
the FAB. This mask determines the access that the opening program has 
while the file is open. If you specify no requested-access mask, 
find/get access is allowed (the OPEN operation uses the mask FBSGET). 
The symbols for requested-access masks are: 


FBSDEL Request find/get/delete access 
FBSGET Request find/get access 

FBSPUT Request put access 

FBSREA Request block read access 

FBSTRN Request find/get/truncate access 
FBSUPD Request find/get/update access 
FBSWRT Request block write access 


Note that FBSREA and FBSWRT override any record access requested. 


Access Sharing 


Specify the kinds of access that your program will share with other 
programs by setting an access-sharing mask in the l-byte SHR field of 
the FAB. The symbols for access-sharing masks are: 


FBSGET Share find/get access 

FBSNIL No access sharing 

FBSUPI Share any access (user-provided interlock) 
FBSWRI Share find/get/put/update/delete access 


The kinds of access sharing are: 
e Shared read access 


Your program is willing to allow other programs to read the 
file, but not to write it. 


e Shared write access 


Your program is willing to allow other programs to both read 
and write the file. Shared write access is not allowed for a 
sequential file unless the file has undefined record format 
and your program opens the file for block access; shared 
write access is also not allowed for a relative or indexed 
file that your program opens for block access. In such cases, 


RMS-11 automatically converts’ the shared write access 
specification to a shared read access specification 
internally. 
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No shared access 


Your program is not willing to allow other programs to either. 
read or write the file. RMS-11 does, however, allow other 
programs to read the file unless your program also requests 
some form of write access. 


e User-provided interlocking 


Your program and other cooperating programs define and enforce 
their own access interlocking; RMS-11 does not check access 
sharing. User-provided interlocking is allowed only for 
sequential disk files; otherwise, the FBSUPI mask is ignored 
(but other masks are honored). 


Deferred Writing 


If you want deferred buffer writing for the open file, set the FBSDFW 
mask in the l-word FOP field of the FAB; This means that RMS-11l does 
not necessarily write its buffers during a write-type operation 
(DELETE, PUT, or UPDATE), but instead writes buffers only when it 
needs them for other operations (or when your program executes the 
FLUSH operation for the stream). 


If you do not set the FBSDFW mask, the DELETE, PUT, and UPDATE 
operations write buffers to the file immediately. 


Note that record operations always use a form of deferred buffer 
writing for sequential files, and that block operations never use 
deferred buffer writing. Therefore you need only decide whether to 
use deferred writing for a record stream to a relative or indexed 
file. 


File Locking 


If you want the file to remain unlocked even if it is closed 
abnormally, set the FBSDLK mask in the l-word FOP field of the FAB; 
if you do not set this mask, the operating system locks the file if it 
is closed abnormally. 


Magtape Beginning-of-File Positioning 


If you have requested some form of write access, and if you want a 
magtape file positioned to the beginning of the file when it is 
opened, set the FBSNEF mask in the l-word FOP field of the FAB; if 
you do not set this mask, and if you requested some form of write 
access, the magtape is positioned to the end-of-file when the file is 
opened. 


Rewinding Magtape Before Open 


If you want a magtape rewound before a magtape file is opened, set the 
FBSRWO mask in the l-word FOP field of the FAB; if you do not set 
this mask, the OPEN operation searches only from the current magtape 
position to the end of the magtape. 
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Rewinding Magtape on Close 


If you want the magtape rewound when the opened file is closed, set 
the FBSRWC mask in the l-word FOP field of the FAB. If you do not set 
this mask, the magtape will not be rewound on close unless you set the 
FBSRWC mask for the CLOSE operation. Note, however, that if you set 
the FBSRWC mask for the OPEN operation, the magtape will be rewound 
even if you do not set the FBSRWC mask for the CLOSE operation. 


RETURNED VALUES 


Internal File Identifier 


The OPEN operation writes an internal file identifier in the l-word 
IFI field of the FAB. (The CLOSE operation clears the internal file 
identifier.) 


The CLOSE, CONNECT, DISPLAY, and EXTEND operations read the internal 
file identifier; do not alter the IFI field while the file is open. 


Device Characteristics 


The OPEN operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBS$CCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 


e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-1l1 treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FB$SQD mask in the 
l-byte DEV field of the FAB). 


Device, Directory, and File Identifiers 


If you supply a NAM block, the OPEN operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block (unless directory 
processing was bypassed due to use of the file identifier on input), 
and a file identifier in the 3-word FID field of the NAM block. 


Expanded String 
If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the OPEN operation writes the expanded 


string for the opened file in this buffer, and writes the length (in 
bytes) of the string in the l-byte ESL field of the NAM block. 
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File Allocation, Bucket Size, and Contiguity 


The OPEN operation writes the file allocation size (in blocks) in the 
2-word ALQ field of the FAB, and the file bucket size or largest area 
bucket size (in blocks) in the 1l-byte BKS field of the FAB. If the 
file is contiguous, the OPEN operation sets the FBSCTG mask in the 
l-word FOP field of the FAB. 


Extension size 


The OPEN operation writes the current default extension size for the 
open file in the l-word DEQ field of the FAB. 


File Organization 


The OPEN operation writes the file organization code in the 1l-byte ORG 
field of the FAB. The symbols for file organization codes are: 


FBSIDX Indexed file organization 
FBSREL Relative file organization 
FBSSEQ Sequential file organization 


Record Format 


The OPEN operation writes the record format code in the 1l-byte REM 
field of the FAB. The symbols for record format codes are: 


FBSFIX Fixed-length record format 
FBSSTM Stream record format 

FBSUDF Undefined record format 
FBSVAR Variable-length record format 
FBSVFC VFC record format 


If the record format is VFC, the OPEN operation writes the size (in 
bytes) of the VEC header field in the l-byte FSZ field of the FAB; 
otherwise it writes 0 in the FSZ field. 


Blocked Records (Sequential Disk File) 


If the file was created specifying blocked records, the OPEN operation 
sets the FBSBLK mask in the l-byte RAT field of the FAB. (The OPEN 
operation sets the mask if it was set when the file was created, even 
if the file is not a sequential file; preservation of this mask 
allows you to copy a sequential file to a file of a different 
organization and back without losing the blocked-record 
characteristic.) 


Record-Output Handling 


The OPEN operation writes the record-output mask in the 1l-byte RAT 
field of the FAB. The symbols for record-output masks are: 


FBSCR Add CRLF to print record (LF-record-CR) 
FBSFTN FORTRAN-style carriage-control character in record 
FBSPRN VFC print record handling 
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Record Size 


The OPEN operation writes the maximum permitted record size (in bytes) 
in the l-word MRS field of the FAB. 


Maximum Record Number 


If the file is a relative file (FBSREL in the ORG field), the OPEN 
operation writes the maximum record number in the 2-word MRN field of 
the FAB (unless you are opening the file for block access). 


Magtape Block Size 


For a magtape file, the OPEN operation writes the block size (in 
characters) in the l-word BLS field of the FAB. 


Longest Record Length 
t 


The OPEN operation writes the length of the longest record in the file 
in the l-word LRL field of the FAB; this value is meaningful only for 
sequential files. 


Area Descriptions 


For each ALL block that you supply, the OPEN operation writes a 
description in its fields of the corresponding area of the file 
(unless you are opening the file for block access). Area 0 is 
described in the ALL block containing 0 in its AID field, area 1 is 
described in the ALL block containing 1 in its AID field, and so 
forth. 


The OPEN operation writes three sizes for a file area: the size (in 
blocks) of the unused portion of the area in the 2-word ALQ field of 
the ALL block, the default area extension size (in blocks) in the 
l-word DEQ field of the ALL block, and the area bucket size (in 
blocks) in the l-byte BKZ field of the ALL block. (If you are opening 
the file for block access, only the ALL block for area 0 is written, 
and the ALL block contains the current file allocation size, default 
file extension size, and file bucket size.) 


The OPEN operation clears the 1-byte ALN field of the ALL block and 
the XBSHRD mask in the l-byte AOP field of the ALL block. If you are 
opening a sequential or relative file for any access, or an indexed 
file for block access, the OPEN operation sets the XBSCTG mask in the 
l-byte AOP field of the ALL block if the file is contiguous; 
otherwise it clears the entire l-byte AOP field of the ALL block. 


Key Descriptions 


For each KEY block that you supply, the OPEN operation writes a 
description in its fields of the corresponding index of the file. 
(The OPEN operation does not write in KEY blocks if you are opening 
the file for block access.) 


The primary index is described in the KEY block containing 0 in its 
REF field, the first alternate index is described in the KEY block 
containing 1 in its REF field, and so forth. 
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The OPEN operation writes the key data type code in the l-byte DTP 
field of the KEY block. The symbols for key data type codes are: 


XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


The OPEN operation writes the sizes of key segments in the 8-byte SIZ 
field of the KEY block. The size (in bytes) of the first key segment 
is in the first byte of the SIZ field, the size of the second segment 
is in the second byte of the SIZ field, and so forth. If the key has 
fewer than eight segments, the first byte containing 0 establishes the 
number of key segments. 


The OPEN operation writes the positions of key segments in the 8-word 
POS field of the KEY block. The position (leftmost position is 0) of 
the first key segment is in the first word of the POS field, the 
position of the second segment is in the second word of the POS field, 
and so forth. If the key has fewer than eight segments, the remaining 
words of the POS field contain unpredictable values. 


The OPEN operation writes a key flags mask in the 1-byte FLG field of 
the KEY block. The symbols for key flags masks are: 


XBSCHG Record key changes allowed on update 
XBSDUP Duplicate record keys allowed 
XBSINI No entries yet made in index 
XBSNUL Null record keys not indexed 


The OPEN operation writes the null-key character in the l-byte NUL 
field of the KEY block; this character is meaningful only if the 
XBSNUL mask in the FLG field is set and if the key is a string key 
(XBSSTG in the DTP field). 


The OPEN operation writes area numbers for the index: the area for 
the data level in the l-byte DAN field of the KEY block, the area for 
the lowest index level in the l-byte LAN field of the KEY block, and 
the area for higher index levels in the l-byte IAN field of the KEY 
block. 


The OPEN operation writes bucket fill numbers for the index areas: 
the fill number for the data area in the l-word DFL field of the KEY 
block, and the fill number for the index areas in the l-word IFL field 
of the KEY block. 


The OPEN operation writes bucket sizes for index areas: the data area 
bucket’ size (in blocks) in the l-byte DBS field of the KEY block, and 
the index area bucket size (in blocks) in the l-~byte IBS field of the 
KEY block. 


The OPEN operation writes virtual block numbers for the index areas: 
the virtual block number for the first data bucket in the 2-word DVB 
field of the KEY block, and the virtual block number of the root index 
bucket in the 2-word RVB field of the KEY block. 


The OPEN operation writes the number of levels in the index (not 
including the data level) in the l-byte LVL field of the KEY block. 


The OPEN operation writes the minimum size (in bytes) of a record that 
contains the key for the index in the l-word MRL field of the KEY 
block. 
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The OPEN operation writes key segment information for the index: the 
number of key segments in the l-byte NSG field of the KEY block, and 
the total key size (sum of segments, in bytes) in the l-byte TKS field 
of the KEY block. 


File Owner and Protection (Disk File) 


If the file is a disk file, and if you supply a PRO block, the OPEN 
operation writes the project (or group) portion of the file owner code 
in the l-word PRJ field of the PRO block, the programmer (or member) 
portion of the file owner code in the l-word PRG field of the PRO 
block, and the file protection code in the l-word PRO field of the PRO 
block. 


File Dates 


If you supply a DAT block for a disk file, the OPEN operation writes 
four values in its fields: the creation date in the 4-word CDT field 
of the DAT block, the expiration date in the 4-word EDT field of the 
DAT block, the revision date in the 4-word RDT field of the DAT block, 
and the revision number (number of times the file has been opened for 
write access and then closed) in the 1l-word RVN field of the DAT 
block. 


File Summary Information 


If you supply a SUM block and are opening an indexed file, the OPEN 
operation writes three values in its fields: the number of file areas 
in the l-byte NOA field of the SUM block, the number of file indexes 
in the l-byte NOK field of the SUM block, and the prologue version 
number (for a relative or indexed file) in the l-word PVN field of the 
SUM block. (If you are opening the file for block access, the OPEN 
operation returns the number of areas and the number of keys as 0, and 
does not return the prologue version number.) 


File Specification Characteristics 


The OPEN operation sets masks in the l-word FNB field of the NAM block 
to show which file specification elements were present in the file 
string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Wildcard Context Information 


If you cleared the FBSFID mask, the OPEN operation clears the NBSWCH 
mask in the l-word FNB field of the NAM block and the 1l-byte RSL field 
of the NAM block; this shows that no wildcard context information 
exists after the operation and that no resultant string was returned. 
If you set the FBSFID mask, the OPEN operation does not alter the 
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NBSWCH mask, and (if the NBSWCH mask is set) does not alter the RSL 
field. 


Completion Status and Value 


The OPEN operation returns completion status in the l-word sTS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-37 lists control block fields that are input to the OPEN 
operation, Table 5-38 lists control block fields that are output by 
the OPEN operation. 


Table 5-37: OPEN Input Fields 


a et er ye 
Block Field Description 


Se ee 


ALL AID Area number 

ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) . 
FAB DEQ While-open file default extension size (blocks) 
FAB DNA . Default string address 

FAB DNS Default string size (bytes) 

FAB FAC Requested access mask 


FBSDEL Request find/get/delete access 
FBSGET Request find/get access 

FBSPUT Request put access 

FBSREA Request block read access 

FBSTRN Request find/get/truncate access 
FBSUPD Request find/get/update access 
EBSWRT Request block write access 


FAB FNA File string address 
FAB FNS File string size (bytes) 
FAB FOP File processing option mask 


FBSDFW Defer writing 

FBSDLK No file locking on abnormal close 

FBSFID Use information in NAM block 

FBSNEF No end-of-file magtape positioning 
FBSRWC Rewind magtape after closing file 

FBSRWO Rewind magtape before searching for file 


FAB LCH Logical channel number 
PAB NAM NAM block address 

FAB RTV Retrieval pointer count 
FAB SHR Shared access mask 


FBSGET Share find/get access 

FBSNIL No access sharing 

FBSUPI Share any access (user-provided interlock) 
FBSWRI Share find/get/put/update/delete access 


(Continued on next page) 
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Table 5-37 (Cont.): OPEN Input Fields 


I 


Block Field Description 


a 


FAB XAB XAB address 

KEY KNM Key name buffer address 

KEY NXT Next XAB address 

KEY REF Index reference number 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 

NAM ESS Expanded string buffer size (bytes) 
NAM FID File identifier 

NAM FNB File specification mask 


NBSWCH Wildcard context established 


PRO NXT Next XAB address 
SUM NXT Next XAB address 


Table 5-38: OPEN Output Fields 


A 


Block Field Description 


nn rrr Tos 


ALL ALN Area alignment mask 
ALL ALQ Unused area allocation size (blocks) 
ALL AOP Area option mask 


XBSCTG Contiguous area 
XBSHRD Hard area location (cleared) 


ALL BKZ Area bucket size (blocks) 

ALL DEQ Area default extension size (blocks) 
DAT CDT File creation date 

DAT EDT File expiration date 

DAT RDT File revision date 

DAT RVN File revision number 

FAB ALQ Current file allocation (blocks) 

FAB BKS File bucket size (blocks) 

FAB BLS Magtape block size (characters) 

FAB DEQ Current file default extension size (blocks) 
FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB FOP File processing option mask 


FBSCTG Contiguous file 


FAB FSZ Fixed control area size for VFC records (bytes) 
FAB IFI Internal file identifier 
FAB LRL Longest record length 
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Table 5-38 (Cont.): OPEN Output Fields 


TT eee, 


Block Field 


Description 


re —_— eee 


FAB 
FAB 
FAB 


FAB 


FAB 


FAB 
FAB 
KEY 
KEY 
KEY 
KEY 


KEY 
KEY 


KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 
KEY 


RAT 


REM 


STS 
STV 
DAN 
DBS 
DFL 
DTP 


DVB 
FLG 


IAN 
IBS 
IFL 
LAN 
LVL 
MRL 
NSG 
NUL 
POS 


Maximum record number 
Maximum record size (bytes) 
File organization code 


FBSSEQ Sequential file organization 
FBSREL Relative file organization 
FBSIDX Indexed file organization 


Record handling mask 


FBSBLK Blocked records 


FBSCR Add CRLF to print record (LF-record-CR) 
FBSFTN FORTRAN-style carriage-control character in 
record 


FBSPRN VFC print record handling 
Record format code 


FBSUDF Undefined record format 
FBSFIX Fixed-length record format 
FBSVAR Variable-length record format 
FBSVFC VFC record format 

FBSSTM Stream record format 


Completion status code 
Completion status value 

Data area number 

Data area bucket size (blocks) 
Data bucket fill factor © 

Key data type code 


XBSBN2 lé-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


First data bucket virtual block number 
Index option mask 


XBSCHG Record key changes allowed on update 
XBSDUP Duplicate record keys allowed 
XBSINI No entries yet made in index 
XBSNUL Null record keys not indexed 


Higher level index area number 

Index area bucket size (blocks) 

Index bucket fill factor 

Lowest index level area number 

Number of index levels (not including data level) 
Minimum length of record containing key (bytes) 
Key segment count 

Null key character 

Key segment positions 


(Continued on next page) 
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KEY 
KEY 
KEY 
NAM 
NAM 
NAM 
NAM 
NAM 


RVB 
SIaZ 
TKS 
DID 
DVI 
ESL 
FID 
FNB 
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Table 5-38 (Cont.): OPEN Output Fields 


Description 


Root index bucket virtual block number 

Key segment sizes (bytes) 

Total key size (sum of key segment sizes) (bytes) 
Directory identifier | 

Device identifier 

Expanded string length (bytes) 

File identifier 

File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file. string or 
default string 

NBSWCH Wildcard context established 


Resultant string length (bytes) (cleared) 
Programmer or member portion of file owner code 
Project or group portion of file owner code 
File protection code 

Number of areas 

Number of indexes 

Prologue version number 


ee 
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5.20 SPARSE MACRO 


The SPARSE macro calls the PARSE operation routine to analyze a file 
specification. 


FORMAT 
The format for the SPARSE is: 
SPARSE fabaddr[,[erraddr} [,sucaddr]] 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the PARSE operation. 


If you supply a NAM block for the PARSE operation, the operation 
routine writes file information in its fields. This information is 
suitable as input to subsequent wildcard SEARCH operations, 


To supply a NAM block for the PARSE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the PARSE 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABS, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive, 


All ALL blocks must be together in the chain of XABS, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


File Specification 


The PARSE operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-1l1 defaults {which contribute 
elements not present in either the file string or the default string). 
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RMS—11 defaults are: 


Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


@ Directory -- The current directory for the task. 
@ Name, type, version -- Defaulted to null. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the PARSE 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
PARSE operation uses no default string. 


Expanded String Buffer 


If you want the PARSE operation to return the expanded string for the 
file, provide a buffer for the string. If you want subsequent 
wildcard SEARCH operations to use the results of the PARSE operation, 
you must provide an expanded string buffer. 


Specify the address of the expanded string buffer in the 1-word ESA 
field of the NAM block. Specify the size (in bytes) of the expanded 
string buffer in the l-byte ESS field of the NAM block; if you 
specify 0 in the ESS field, the PARSE operation does not return the 
expanded string. 


Private Buffer Pool 


If you want the PARSE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the PARSE 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the PARSE operation in the l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 


RETURNED VALUES 


Wildcard Initialization 


If you supplied a NAM block to be initialized for wildcard SEARCH 
operations, the PARSE operation clears several fields: the 3-word DID 
field of the NAM block, the l-byte RSL field of the NAM block, the 
l-word wcc field of the NAM block, and the l-word WDI field of the NAM 
block. These cleared fields are part of the initialization for 
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subsequent wildcard SEARCH operations. 


The PARSE operation writes a match-pattern (for subsequent wildcard 
SEARCH ‘operations) in the expanded string buffer, and writes the 
length (in bytes) of the expanded string in the l-byte ESL field of 
the NAM block. 


The PARSE operation sets the NBSWCH mask in the 1l-~word FNB field of 
the NAM block, showing that wildcard information in the NAM block is 
initialized. 


Device Characteristics 


The PARSE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


® Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


® Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the l-byte DEV field of the FAB); RMS-~1l treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@ Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-1l1 treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FBSSQD mask in. the 
l-byte DEV field of the FAB). 


Device Identifier 


If you supply a NAM block, the PARSE operation writes a device 
identifier in the 2-word DVI field of the NAM block. 


File Specification Characteristics 


The PARSE operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. These masks and their meanings are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 
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Expanded String 


If you supply a NAM block, and if the input file specification string 
does not contain wildcard characters, the PARSE operation writes the 
expanded string in the expanded string buffer; this string is a fully 
qualified file specification except that the file version number (if 
any) from the. input file specification is unchanged. 


Completion Status and Value 


The PARSE operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-39 lists control block fields that are input to the PARSE 
operation. Table 5-40 Lists control block fields that are output by 
the PARSE operation. 


Table 5-39: PARSE Input Fields 


a 


Block Field Description 


et 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM ESA Expanded string buffer address 
NAM ESS Expanded string buffer size (bytes) 
PRO NXT Next XAB address 

SUM NXT Next XAB address 


Table 5-40: PARSE Output Fields 


I 


Block Field Description 


FAB DEV Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


FAB STs Completion status code 

FAB STV Completion status value 

NAM DID Directory identifier (cleared) 
NAM DVI Device identifier 

NAM ESL Expanded string length (bytes) 


(Continued on next page) 
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; Table 5-40 (Cont.): PARSE Output Fields 
a a a es 
Block Field Description 


NAM FNB File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWCH Wildcard context established 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string or 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 


NAM RSL Resultant string length (bytes) (cleared) 
NAM wcc Wildcard context (cleared) 
NAM WDI Wildcard directory context (cleared) 


ne eee 
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5.21 $PUT MACRO (SEQUENTIAL ACCESS) 


The SPUT macro calls the PUT operation routine to transfer a record 
from a user buffer to an I/O buffer and to a file. 


The target of a sequential-access PUT operation depends on the file 
organization: 


® For a sequential file, the target of a sequential-access PUT 
operation is the end-of-file, and the next-record context must 
be the end-of-file. 


@ For a relative file, the target of a sequential-access PUT 
operation is the next cell (as determined by the next-record 
context or by the context of an immediately preceding 
sequential access PUT operation). 

® For an indexed file, a sequential-access PUT operation has no 
target; the PUT operation inserts the record and updates 
indexes. If the immediately preceding operation was also a 
sequential access PUT operation, the primary key value in your 
record must be greater than or equal to the primary key value 
of the preceding record. 

FORMAT 
The format for the SPUT is: 

SPUT rabaddr[, [erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the PUT operation. 
OPTIONS 


Internal Stream Identifier 

The PUT operation reads the internal stream identifier from the 1l-word 
ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the PUT operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the PUT operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABS$B macro that 
declared the RAB for the asynchronous operation.) 


Sequential Access 


Specify the RBSSEQ code in the l-byte RAC field of the RAB. 
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Record 


Specify the address of the record to be transferred in the l-word RBF 
field of the RAB, and the size (in bytes) of the record in the l-word 
RSZ field of the RAB, 


If the record is in VFC format, specify the address of the 
fixed-length portion of the record in the l-word RHB field of the RAB. 
If you specify 0 in this field, the record header will be null-filled. 


Locate Mode 


For a sequential file, if you want the PUT operation to use locate 
mode, specify the address of the user buffer in the l-word UBF field 
of the RAB, specify the maximum size of the record for the next PUT 
operation in the l-word USZ field of the RAB, and set the RBSLOC mask 
in the l-word ROP field of the RAB. 


The PUT operation returns (in the RBF field) the address of a location 
where your program can build the next record for output. The maximum 
next record size that you specify in the USZ field determines whether 
the next record can fit into an I/O buffer. 


Bucket Fill Number Honoring 


If you want the PUT operation to honor bucket fill numbers’ for the 
file and its areas, set the RBSLOA mask in the l-word ROP field of the 
RAB. If you do not set this mask, the PUT operation fills buckets 
without regard to bucket fill numbers. 


Update Existing Record (Relative File) 


If you want to transfer the record to a cell in a relative file even 
if the cell contains a record, set the RBSUIF mask in the l-word ROP 
field of the RAB. If you do not set this mask, and if the cell 
already contains a record, the PUT operation returns an error 
completion and does not transfer the record. 


Mass Insertion (Indexed File) 


For an indexed file, using mass-insertion mode for a series of PUT 
operations speeds up the insertion of a series of records. To use 
mass-insertion mode for a series of records, set the RBSMAS mask in 
the l-word ROP field of the RAB for each PUT operation in the series. 


STREAM CONTEXT 


The current-record and next-record contexts after a sequential access 
PUT operation are undefined. 
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RETURNED VALUES 


Next Record Buffer 


If you specified locate mode for the PUT operation, the PUT operation 
returns the address of a location where your program can build the 
next record for output in the l-word RBF field of the RAB. This 
address gives a location in the 1/0 buffer (if there is room for 
another record there), or the location of your user buffer (if not). 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, a sequential-access PUT operation returns the relative record 
number (RRN) for the inserted record in the 2-word BRKT field of the 
RAB. 


RFA 


The PUT operation returns the record file address (RFA) for the 
inserted record in the 3-word RFA field of the RAB. 


Completion Status and Value 


The PUT operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-41 lists control block fields that are input to the PUT 
operation. Table 5-42 lists control block fields that are output by 
the PUT operation. 


fable 5-41: PUT (Sequential Access) Input Fields 


ee en ee a ae eee TS 


Block Field Description 


nn 


RAB ISI Internal stream identifier 
RAB RAC Record access code 


RBSSEQ Sequential access 


RAB RBF Record buffer address 
RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOA Honor bucket fill numbers 
RBSLOC Locate mode 

RBSMAS Mass insert 

RBSUIF Update if record exists 


RAB RSZ Record size (bytes) 
RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 
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Block Field 


Table 5-42: PUT (Sequential Access) Output Fields 


Description 


RAB 
RAB 
RAB 
RAB 
RAB 


BKT 
RFA 
RBF 
sts 
STV 


Relative record number (RRN) 
Record file address 

Record buffer address 
Completion status code 
Completion status value 
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5.22 $PUT MACRO (KEY ACCESS) 
The SPUT macro calls the PUT operation routine to transfer a record 
from a user buffer to an I/O buffer and to a sequential disk file 


(with fixed-length records), a relative file, or an indexed file. 


The target of a key-access PUT operation depends on the file 
organization: 


@ For a sequential disk file (with fixed-length records) or a 
relative file, the key is a relative record number (RRN), and 
the target of a key-access PUT operation is the cell specified 
by the RRN. 

e For an indexed file, a key-access PUT operation has no target; 
the PUT operation inserts the record and updates indexes. 

FORMAT 
The format for the S$PUT is: 

SPUT rabaddr[,{erraddr] [,sucaddr] ]} 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the PUT operation. 
OPTIONS 


Internal Stream Identifier 

The PUT operation reads the internal stream identifier from the l-word 
ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the PUT operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the PUT operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Key Access 


Specify the RBSKEY code in the l-byte RAC field of the RAB. 


Record 


Specify the address of the record to be transferred in the l-word RBF 
field of the RAB, and the size (in bytes) of the record in the 1l-word 
RSZ field of the RAB. 
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If the record is in VFC format, specify the address of the 
fixed-length portion of the record in the 1l-word RHB field of the RAB. 
If you specify 0 in this field, the record header will be null-filled. 


Record Buffer 


Specify a record buffer tor the PUT operation; specify the address of 
the record buffer in the l-word UBF field of the RAB; specify the 
size (in bytes) of the record buffer in the l-word USZ field of the 
RAB. 


Note that the value in the UBF field will be used (copied to the RBF 
field) only if you specify locate mode. A request for locate mode is 
otherwise ignored for a key access PUT operation. 


RRN 


For a relative file or for a sequential disk file with fixed-length 
records, specify a 4-byte relative record number (RRN) in the 1l-word 
KBF field of the RAB, and specify 0 or 4 in the l-byte KSZ field of 
the RAB. 


Bucket Fill Number Honoring 

If you want the PUT operation to honor bucket fill numbers’ for’ the 
file and its areas, set the RBSLOA mask in the l-word ROP field of the 
RAB. If you do not set this mask, the PUT operation fills buckets 
without regard to bucket fill numbers. 

Update Existing Record (Relative File) 

If you want to transfer the record to a cell in a relative file even 
if the cell contains a record, set the RBSUIF mask in the l-word ROP 
field of the RAB. If you do not set this mask, and if the cell 


already contains a record, the PUT operation returns an error 
completion and does not transfer the record. 


STREAM CONTEXT 


The current-record context after a key access PUT operation is 
undefined; the next-record context is unchanged. 


RETURNED VALUES 


RRN 
For a relative file or for a sequential disk file with fixed-length 


records, a key-access PUT operation returns the relative record number 
(RRN) for the inserted record in the 2-word BKT field of the RAB. 


RFA 


The PUT operation returns the record file address (RFA) for the 
inserted record in the 3-word RFA field of the RAB. 


OPERATION MACRO DESCRIPTIONS 
SPUT MACRO (KEY ACCESS) 


Completion Status and Value 


The PUT operation returns completion status in the l-word STS field of 
the RAB and returns a completion value in the l-word STV field of the 
RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-43 lists control block fields that are input to the PUT 
operation. Table 5-44 lists control block fields that are output by 
the PUT operation. 


Table 5-43: PUT (Key Access) Input Fields 
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Block Field Description 


RAB ISI Internal stream identifier 
RAB KBE Key buffer address 

RAB KSZ Key size (bytes) 

RAB RAC Record access code 


RBSKEY Key access 


RAB RBFE Record buffer address 
RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOA Honor bucket fill numbers 
RBSLOC Locate mode 

RBSUIF Update if record exists 


RAB RSZ Record size (bytes) 
RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


th 


Table 5-44: PUT (Key Access) Output Fields 


i A A 


Block Field Description 


a 


RAB BRKT Relative record number (RRN) 
RAB RBF Record buffer address 

RAB RFA Record file address 

RAB sts Completion status code 

RAB STV Completion status value 


a 
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5.23 $READ MACRO (SEQUENTIAL ACCESS) 

The S$READ macro calls the READ operation routine to transfer blocks 
from a file to an I/O buffer. The target of a sequential-access READ 


operation is the readable block (and, for a multiblock READ operation, 
following blocks). 


FORMAT 
The format for the SREAD is: 

SREAD rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the READ operation. 
OPTIONS 


Internal Stream Identifier 


The READ operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Specification 


For a sequential-access READ operation, specify 0 in the 2-word BRT 
field of the RAB. 


User Buffer 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 


For a magtape file, the READ operation reads at most one magtape block 
into the buffer; for other files, the READ operation fills the buffer 
(unless it reached the end-of-file before the buffer is filled). 


Asynchronous Operation 


If you want to execute the READ operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the READ operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


The readable-block context after a READ operation is the block 
following the tlast-read block; the writable-block context is the 
first-read block. 
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RETURNED VALUES 


Data Blocks 


The READ operation returns the address and length of the data read 
from the file. The value in the l-word RBF field of the RAB is the 
address of the data read; the value in the l-word RSZ field of the 
RAB is the length (in bytes) of the data read. 


The READ operation normally will not read beyond the logical 
end-of-file. For sequential files with undefined (UDF) record format, 
however, the READ operation will respect the logical end-of-file 
marker only if you have specified no write-sharing in the l-byte SHR 
field of the FAB. If you specify write-sharing, RMS-1l1 will ignore 
the logical end-of-file marker and will stop only at the physical 
end-of-file on the disk. 


Record File Address (RFA) 


The READ operation returns the virtual block number of the first-—read 
block in the first two words of the 3-word RFA field of the RAB (it 
clears the third word). 


Completion Status and Value 


The READ operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-45 lists control block fields that are input to the READ 
operation. Table 5-46 lists control block fields that are output by 
the READ operation. 


Table 5-45: READ (Sequential Access) Input Fields 


a 


Block Field Description 


ne 


RAB BKT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


ee 


Table 5-46: READ (Sequential Access) Output Fields 


a a 


Block Field Description 


i 


RAB RBF Record buffer address 

RAB RFA Virtual block number (2 words) 
RAB RSZ Record size (bytes) 

RAB STS Completion status code 

RAB STV Completion status value 


i 
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5.24 S$READ MACRO (VBN ACCESS) 

The SREAD macro calls the READ operation routine to transfer blocks 
from a file to an I/O buffer. The target of a VBN-access READ 


Operation is a specified block (and, for a multiblock READ operation, 
following blocks). 


FORMAT 
The format for the SREAD is: 

SREAD rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the READ operation. 
OPTIONS 


Internal Stream Identifier 


The READ operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Specification 


Specify the virtual block number of the first block to be read in the 
2-word BKT field of the RAB. 


User Buffer 


Specify the address of the user buffer in the l-word UBF field of the 
RAB, and specify the size (in bytes) of the user buffer in the l-word 
USZ field of the RAB. 


For a magtape file, the READ operation reads at most one magtape block 
into the buffer; for other files, the READ operation fills the buffer 
(unless it reached the end-of-file before the buffer is filled). 


Asynchronous Operation 


If you want to execute the READ operation asynchronously, set the 
RBSASY mask in the l-word ROP field of the RAB;. if you do not set 
this mask, the READ operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


The readable-block context after a READ operation is the _ block 
following the last-read block; the writable-block context is the 
first-read block. 
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RETURNED VALUES 


Data Blocks 


The READ operation returns the address and length of the data read 
from the file, The value in the l-word RBF field of the RAB is the 
address of the data read; the value in the l-word RSZ field of the 
RAB is the length (in bytes) of the data read. 


The READ operation normally will not read beyond the logical 
end-of-file. For sequential files with undefined (UDF) record format, 
however, the READ operation will respect the logical end-of-file 
marker only if you have specified no write-sharing in the l-byte SHR 
field of the FAB. If you specify write-sharing, RMS-11 will ignore 
the. logical end-of-file marker and will stop only at the physical 
end-of-file on the disk. 


Record File Address (RFA) 


The READ operation returns the virtual block number of the first-read 
block in the first two words of the 3-word RFA field of the RAB (it 
clears the third word). 


Completion Status and Value 


The READ operation returns completion status in the l-word sTS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-47 lists control block fields that are input to the READ 
operation. Table 5-48 lists control block fields that are output by 
the READ operation. 


Table 5-47: READ (VBN Access) Input Fields 


i 


Block Field Description 


Rt 


RAB BKT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB UBF User buffer address 
RAB USZ User buffer size (bytes) 


fa nt a 


Table 5-48: READ (VBN Access) Output Fields 


i 


Block Field Description 


Sa ES —— 


RAB RBF Record buffer address 

RAB RFA Virtual block number (2 words) 
RAB RSZ Record size (bytes) 

RAB sts Completion status code 

RAB STV Completion status value 


A 
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5.25 $REMOVE MACRO 
The SREMOVE macro calls the REMOVE operation routine to remove the 
directory entry for a file. 
FORMAT 
The format for the SREMOVE is: 

SREMOVE fabaddr[,[erraddr][,sucaddr]} 
where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation, 
CONTROL BLOCKS 
You must supply a FAB for the REMOVE operation. 
If you supply a NAM block and specify remove by NAM block, the REMOVE 
operation reads NAM block fields to obtain identifiers for the target 


file. 


To supply a NAM block for the REMOVE operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the REMOVE 
operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


File Specification (Nonwildcard REMOVE Operation) 


The REMOVE operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-1l1 defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-11 defaults are: 


Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


® Directory -- The current directory for the task. 
e Name, type, version ~- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the 1-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the REMOVE 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
REMOVE operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the REMOVE operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the REMOVE operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


Remove by Wildcard Specification 


You can use the REMOVE operation in a wildcarding program loop. (The 
NBSWCH mask in the l-word FNB field of the NAM block will already have 
been set by an earlier PARSE operation.) 


If you set the FBSFID mask in the l-word FOP field of the FAB, the 
file found by a previous SEARCH operation is removed without affecting 
fields that are used as context for subsequent SEARCH operations. 


If you clear the FBSFID mask in the l-word FOP field of the FAB, the 
REMOVE operation first performs an implicit SEARCH operation. (The 
input and output fields for the SEARCH operation are not described 
here and are not included in the checklists at the end of this 
section.) 


If the SEARCH operation finds a file that matches the wildcard file 
specification, the REMOVE operation removes its directory entry; if 
not, the REMOVE operation does not remove a directory entry, but 
instead passes control block data from the SEARCH operation (in 
particular, the ERSNMF completion status code and the cleared NBSWCH 
mask in the l-word FNB field of the NAM block). 
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Expanded String Buffer 


If you want the REMOVE operation to return the expanded string for the 
file whose directory entry was removed, provide a buffer for the 
string. Specify the address of the expanded string buffer in the 
l-word ESA field of the NAM block. Specify the size (in bytes) of the 
expanded string buffer in the l-byte ESS field of the NAM block; if 
you specify 0 in the ESS field, the REMOVE operation does not return 
the expanded string. 


Private Buffer Pool 


If you want the REMOVE operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the REMOVE 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the REMOVE operation in the l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


RETURNED VALUES 


Device Characteristics 


The REMOVE operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


@e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11l 
treats a printer or terminal as a unit-record device. 


@e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1l-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 


@ Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-11 treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 
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Device, Directory, and File Identifiers 


If you supply a NAM block, the REMOVE operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block, and a file 
identifier in the 3-word FID field of the NAM block. 


Expanded String 


If you specify a buffer for the expanded string for the file (ESA and 
ESS fields in the NAM block), the REMOVE operation writes the expanded 
string for the target file in this buffer, and writes the length (in 
bytes) of the string in the l-byte ESL field of the NAM block. 


File Specification Characteristics 


The REMOVE operation sets the masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. 


These masks and their meaning are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 
NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default string 
NBSWNA Wildcard file name in file string or default string 
NBSWTY Wildcard file type in file string or default string 
NBSWVE Wildcard file version in file string or default string 


Wildcarding 

The REMOVE operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block; this shows that no wildcard context exists after the 
REMOVE operation. It also clears the l-byte RSL field of the NAM 
block to show that no resultant string was returned. 

Completion Status and Value 

The REMOVE operation returns completion status in the 1l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-49 lists control block fields that are input to the REMOVE 


operation. Table 5-50 lists control block fields that are output by 
the REMOVE operation. 
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Block Field 


ALL 
DAT 
FAB 
FAB 
FAB 
FAB 
FAB 
FAB 
FAB 


FAB 
FAB 
KEY 
NAM 
NAM 
NAM 
NAM 
NAM 
NAM 


PRO 
SUM 


NXT 
NXT 
BPA 
BPS 
DNA 
DNS 
FNA 
FNS 
FOP 


LCH 
NAM 
NXT 
DID 
DVI 
ESA 
ESS 
FID 
FNB 


NXT 
NXT 


Table 5-49: REMOVE Input Fields 


Description 


Next XAB address 

Next XAB address 

Private buffer pool address 
Private buffer pool size (bytes) 
Default string address 

Default string size (bytes) 

File string address 

File string size (bytes) 

File processing option mask 


FBSFID Use information in NAM block 


Logical channel number 

NAM block address 

Next XAB address 

Directory identifier 

Device identifier 

Expanded string buffer address 
Expanded string buffer size (bytes) 
File identifier 

File specification mask 


NBSWCH Wildcard context established 


Next XAB address 
Next XAB address 


Table 5-50: REMOVE Output Fields 


Block Field 


Description 


FAB 


FAB 
FAB 
NAM 
NAM 
NAM 
NAM 


DEV 


STS 
STV 
DID 
DVI 
ESL 
FID 


Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


Completion status code 
Completion status value 
Directory identifier 

Device identifier 

Expanded string length (bytes) 
File identifier 


(Continued on next page) 
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Table 5-50 (Cont.): REMOVE Output Fields 


Description 


File specification mask 


NBSNOD 
NBSDEV 
NBSDIR 
NBSQUO 
NBSNAM 
NBSTYP 
NBSVER 
NBSWDI 
NBSWNA 
NBSWTY 
NBSWVE 


NBSWCH 


Node in file string or default string 
Device in file string or default string 
Directory in file string or default string 
Quoted string in file string or default 
string 

File name in file string or default string 
File type in file string or default string 
File version in file string or default 
string 

Wildcard directory in file string or 
default string 

Wildcard file name in file string or 
default string 

Wildcard file type in file string or 
default string 

Wildcard file version in file string or 
default string 

Wildcard context established (cleared) 


Resultant string length (bytes) 
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5.26 SRENAME MACRO 


The SRENAME macro calls the RENAME operation routine to change the 
directory entry for a file. 


The old and new entries (file specifications) must have the same 
network node and device specifications. 


FORMAT 
The format for the SRENAME is: 
SRENAME oldfabaddr,[erraddr] , [sucaddr] ,newfabaddr 


where oldfabaddr is the address of the FAB for the operation; erraddr 
is the address of the error handler for the operation; sucaddr is the 
address of the success handler for the operation; and newfabaddr is 
the address of the FAB giving the new file specification. 


CONTROL BLOCKS 


You must supply two FABs for the RENAME operation: an "old" FAB 
containing the current specification for the file, and a "new" FAB 
containing the new specification for the file. 


I£ you supply a NAM block for the old FAB (old NAM block) and specify 
either rename by NAM block or wildcarding, the RENAME operation reads 
its fields to obtain identifiers for the old file specification. Lf 
you supply a NAM block for the new FAB (new NAM block) and specify 
rename by NAM block, the RENAME operation reads its fields to obtain 
identifiers for the new file specification. 


To supply a NAM block for the RENAME operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the RENAME 
operation, specify the address of the first XAB in the 1l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NxT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABS, and must be in 
ascending order (by the index reference number in the 1l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


Old File Specification (Nonwildcaru RENAME Operation) 


The RENAME operation constructs the full file specification from _ the 
file string, the default string (which contributes only elements not 
present in the file string), and RMS-1l defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-11 defaults are: 


Device -- The device to which the specified logical channel is 
assigned, or SY: if the specified logical channel is not 
assigned to any device. 


e Directory -- The current directory for the task. 
@ Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the RENAME 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
RENAME operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB. and 
supply a NAM block, the RENAME operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the RENAME operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


Old File Specification (Wildcard RENAME Operation) 


You can use the RENAME operation in a wildcarding program loop. (The 
NBSWCH mask in the l-word FNB field of the NAM block will already have 
been set by an earlier PARSE operation.) 


If you set the FBSFID mask in the l-word FOP field of the FAB, the 
file found by a previous SEARCH operation is renamed without affecting 
fields that are used as context for subsequent SEARCH operations. 


If you clear the FBSFID mask in the l-word FOP field of the FAB, the 
RENAME operation first performs an implicit SEARCH operation. (The 
input and output fields for the SEARCH operation are not described 
here and are not included in the checklists at the end of this 
section.) 


If the SEARCH operation finds a file that matches the wildcard file 
specification, the RENAME operation replaces its directory entry; if 
not, the RENAME operation does not replace a directory entry, but 
instead passes control block data from the SEARCH operation (in 
particular, the ERSNMF completion status code and the cleared NBSWCH 
mask in the l-word FNB field of the NAM block). 


New File Specification 
The RENAME operation constructs the full file specification from the 
file string, the default string (which contributes only elements not 


present in the file string), and RMS-ll defaults (which contribute 
elements not present in either the file string or the default string). 
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RMS-11 defaults are; 


Device -- The device that was used for the old file 
specification (The old FAB logical channel is used, and the 
new FAB logical channel is ignored). 


e Directory -- The current directory for the task, 
e Name, type, version -- Defaulted to null. 
The file string and the default string must not contain wildcards. 


Specify the address of the file string in the l-word FNA field of the 
FAB. Specify the size (in bytes) of the file string in the 1l-byte FNS 
field of the FAB; if you specify 0 in the FNS field, the RENAME 
operation uses no file string. 


Specify the address of the default string in the l-word DNA field of 
the FAB. Specify the size (in bytes) of the default string in the 
l-byte DNS field of the FAB; if you specify 0 in the DNS field, the 
RENAME operation uses no default string. 


If you set the FBSFID mask in the l-word FOP field of the FAB and 
supply a NAM block, the RENAME operation reads the device identifier 
from the 2-word DVI field of the NAM block; if this value is nonzero, 
the specified device overrides the device in the merged string. 


In the same circumstance, the RENAME operation reads the directory 
identifier from the 3-word DID field of the NAM block; if this value 
is nonzero, the specified directory overrides the directory in the 
merged string. 


Private Buffer Pool 


If you want the RENAME operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the RENAME 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the RENAME operation in the 1-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


Expanded String Buffers 


If you want the expanded string for the file given by a FAB returned 
to a buffer, supply a NAM block for the FAB. Specify the address of 
the buffer in the l-word ESA field of the NAM block, and the size (in 
bytes) of the buffer in the l-byte ESS field of the NAM block. If you 
do not supply a NAM block for a FAB, or if you specify 0 in the ESS 
field, the RENAME operation does not return the expanded string. 
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RETURNED VALUES 


Expanded Strings 


If you specify a buffer for the expanded string for a FAB (ESA and ESS 
fields in the NAM block), the RENAME operation writes the expanded 
string in the buffer, and writes the length (in bytes) of the string 
in the l-byte ESL field of the NAM block. 


Device Characteristics 


The RENAME operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the 1l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


e Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the l-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 


e Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 


@ Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the l-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-1l treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


e ANSI-format magtape (indicated by the set FB$SQD mask in the 
l-byte DEV field of the FAB). 


Device, Directory, and File Identifiers 


If you supply a NAM block, the RENAME operation writes a device 
identifier in the 2-word DVI field of the NAM block, a directory 
identifier in the 3-word DID field of the NAM block, and a file 
identifier in the 3-word FID field of the NAM block. 


File Specification Characteristics 


The RENAME operation sets masks in the l-word FNB field of the NAM 
block to show which file specification elements were present in the 
file string and default string. 


These masks and their meaning are: 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default string 

NBSWDI Wildcard directory in file string or default string 
\ NBSWNA Wildcard file name in file string or default string 

NBSWTY Wildcard file type in file string or default string 

NBSWVE Wildcard file version in file string or default string 
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Wildcarding 


The RENAME operation clears the NBSWCH mask in the l-word FNB field of 
the NAM block; this shows that no wildcard context exists after the 
RENAME operation. It also clears the l-byte RSL field of the NAM 
block to show that no resultant string was returned. 


Completion Status and Value 


The RENAME operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-51 lists control block fields that are input to the RENAME 
operation. Table 5-52 lists control block fields that are output by 
the RENAME operation, 


NOTE 


The only input fields taken from both 
the "old" and the "new" FPABS are the 
DNA, DNS, FNA, FNS, FOP, and NAM fields. 
All other FAB input fields are taken 
from the "old" FAB only. All FAB output 
fields are returned to the "old" FAB 
only. 


Table 5-51: RENAME Input Fields 
a eh ee 
Block Field Description 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB DNA Default string address 

FAB DNS Default string size (bytes) 

FAB FNA File string address 

FAB FNS File string size (bytes) 

FAB FOP File processing option mask 


FBSFID Use information in NAM block 


FAB LCH Logical channel number 

FAB NAM NAM block address 

KEY NXT Next XAB address 

NAM DID Directory identifier 

NAM DVI Device identifier 

NAM ESA Expanded string buffer address 

NAM ESS Expanded string buffer size (bytes) 
NAM FNB File specification mask 


NBSWCH Wildcard context established 
PRO NXT Next XAB address 


SUM NXT Next XAB address 
nS 
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Table 5-52: RENAME Output Fields 


a 


Block Field 


FAB 


FAB 
FAB 
NAM 
NAM 
NAM 
NAM 
NAM 


NAM 


DEV 


sts 
STV 
DID 
DVI 
ESL 
FID 
FNB 


RSL 


Description 


Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


Completion status code 
Completion status value 
Directory identifier 

Device identifier 

Expanded string length (bytes) 
File identifier 

File specification mask 


NBSNOD Node in file string or default string 

NBSDEV Device in file string or default string 

NBSDIR Directory in file string or default string 

NBSQUO Quoted string in file string or default 
string 

NBSNAM File name in file string or default string 

NBSTYP File type in file string or default string 

NBSVER File version in file string or default 
string 

NBSWDI Wildcard directory in file string or 
default string 

NBSWNA Wildcard file name in file string ox 
default string 

NBSWTY Wildcard file type in file string or 
default string 

NBSWVE Wildcard file version in file string or 
default string 

NBSWCH Wildcard context established (cleared) 


Resultant string length (bytes) 
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5.27 $REWIND MACRO 
The $REWIND macro calls the REWIND operation routine to reset the 
context for a stream to the beginning-of-file. The file can have any 
organization. 
FORMAT 
The format for the SREWIND is: 

SREWIND rabaddr{,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the REWIND operation. 
OPTIONS 


Internal Stream Identifier 


The REWIND operation reads the internal stream identifier ‘from the 
l-word ISI field of the RAB. 


Key of Reference 


For an indexed file, you must specify the index that the stream will 
use in accessing records. Specify this key of reference in the l-byte 
KRF field of the RAB. This value matches the value in the file's KEY 
block for the index: 0 for the primary index, 1 for the first 
alternate index, and so forth. 


Asynchronous Operation 


If you want to execute the REWIND operation asynchronously, set the 
RBSASY mask in the l-word ROP field of the RAB; if you do not set 
this mask, the REWIND operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


For a record access file, the current context after a REWIND operation 
is undefined and the next-record context is the first record in the 
file; for an indexed file, this first record is defined by the 
specified index. 


For a block access file, both the readable-block and writable-block 
contexts after a REWIND operation are the first block in the file. 
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RETURNED VALUES 


Completion Status and Value 


The REWIND operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-53 lists control block fields that are input to the REWIND 
operation, Table 5-54 lists control block fields that are output by 
the REWIND operation. 


Table 5-53: REWIND Input Fields 


nnn 


Block Field Description 


a 


RAB ISI Internal stream identifier 
RAB KRE Key of reference 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


OF a SS See 


Table 5-54: REWIND Output Fields 


van 


Block Field Description 


i ee a ap i i pt lite 


RAB STs Completion status code 
RAB STV Completion status value 


Sn Te 
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5.28 S$SEARCH MACRO 


The $SEARCH macro calls the SEARCH operation routine to scan a 
directory and return a file specification and identifiers in NAM block 
Fields. You should precede the SEARCH operation by a PARSE operation, 
which initializes the NAM block fields for the SEARCH operation. 


The SEARCH operation finds a file specification that matches the 
match-pattern initialized (in the expanded string buffer) by the PARSE 
Operation; a series of wildcard SEARCH operations returns successive 
matching file specifications. 


FORMAT 
The format for the SSEARCH is: 
SSEARCH fabaddr[,[erraddr] [,sucaddr] ]} 


where fabaddr is the address of the FAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 
You must supply a FAB for the SEARCH operation. 
You must supply a NAM block for the SEARCH operation. 


To supply a NAM block for the SEARCH operation, specify the address of 
the NAM block in the l-word NAM field of the FAB. 


To supply XABs (ALL, DAT, KEY, PRO, and SUM blocks) for the SEARCH 
Operation, specify the address of the first XAB in the l-word XAB 
field of the FAB; specify the address of the next XAB (if any) in the 
l-word NXT field of each XAB; specify 0 in the NXT field of the last 
XAB. 


All KEY blocks must be together in the chain of XABs, and must be in 
ascending order (by the index reference number in the l-byte REF field 
of the KEY block); the index reference numbers need not be 
consecutive. 


All ALL blocks must be together in the chain of XABs, and must be in 
ascending order (by the area identifier in the l-byte AID field of the 
ALL block); the area identifiers need not be consecutive. 


Multiple DAT, PRO, or SUM XABs are illegal. 
OPTIONS 


Wildcard Context Information 


The SEARCH operation reads NAM block fields that are initialized, 
written, or preserved by a preceding PARSE or wildcard SEARCH 
operation: the 3-word DID field of the NAM block, the 2-word DVI 
field of the NAM block, the l-word ESA field of the NAM block, the 
l-byte ESL field of the NAM block, the NBSWCH mask in the 1l-word FNB 
field of the NAM block, the l-word RSA field of the NAM block, the 
l-byte RSL field of the NAM block, the l-byte RSS field of the NAM 
block, the l-word WCC field of the NAM block, and the l-word WDI field 
of the NAM block, 
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The SEARCH operation also uses the expanded string in the expanded 
string buffer. 


You must preserve these fields between a PARSE and a SEARCH operation 
and between successive wildcard SEARCH operations. 


Private Buffer Pool 


If you want the SEARCH operation to use a private buffer pool instead 
of the central buffer pool, specify the address of the (word-aligned) 
private buffer pool in the l-word BPA field of the FAB, and its size 
(in bytes) in the l-word BPS field of the FAB; this size must be a 
multiple of 4. 


If you specify 0 in either the BPA field or the BPS field, the SEARCH 
operation uses the central buffer pool. 


Logical Channel 


Specify the logical channel for the SEARCH operation in the 1l-byte LCH 
field of the FAB. The logical channel number must not be the same as 
the logical channel number for any already-open file, and must not be 
0. 


Magtape Positioning 


The FBSRWO mask in the l-word FOP field of the FAB may be set to cause 
a magtape to be rewound prior to the first wildcard SEARCH operation. 
To avoid unpredictable results, the FBSRWO mask in the 1-word FOP 
field of the ‘FAB and FBSRWC mask in the l-word FOP field of the FAB 
should not be set thereafter. 


RETURNED VALUES 


Resultant String 


The SEARCH operation writes the full file specification for the found 
file in the resultant string buffer, and writes the length of the 
string in the l-byte RSL field of the NAM block. 


Device Characteristics 


The SEARCH operation returns device characteristics as masks in the 
l-byte DEV field of the FAB. The device characteristics are: 


e Printer or terminal (indicated by the set FBSCCL mask in the 
l-byte DEV field of the FAB and the set FBSREC mask in the 
l-byte DEV field of the FAB; for a terminal, the FBSTRM mask 
in the l-byte DEV field of the FAB is also set); RMS-11 
treats a printer or terminal as a unit-record device. 


Disk, DECtape, or DECTAPE II (indicated by the set FBSMDI mask 
in the 1-byte DEV field of the FAB); RMS-11 treats a disk, 
DECtape, or DECTAPE II as a disk device. 


Unit-record device (indicated by the set FBSREC mask in the 
l-byte DEV field of the FAB). 
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Non-ANSI magtape or cassette tape (indicated by the set FBSSDI 
mask in the 1-byte DEV field of the FAB and the set FBSREC 
mask in the l-byte DEV field of the FAB); RMS-11 treats a 
non-ANSI magtape or a cassette tape as a unit-record device. 


@ ANSI-format magtape (indicated by the set FBSSQD mask in the 
l-byte DEV field of the FAB). 


Directory and File Identifiers 


If the SEARCH operation finds a file that matches the wildcard 
pattern, it writes the directory identifier for the found file in the 
3-word DID field of the NAM block, and the file identifier in the 
3-word FID field of the NAM block. 


Wildcard Context Information 


The SEARCH operation writes the wildcard context in the 1l-word wecc 
field of the NAM block, and the wildcard directory context in the 
l-word WDI field of the NAM block. 


If the SEARCH operation did not find a matching file, it clears the 
NBSWCH mask in the l-word FNB field of the NAM block; this shows that 
no further wildcarding is possible using the current wildcard 
information. 


Completion Status and Value 


The SEARCH operation returns completion status in the l-word STS field 
of the FAB and returns a completion value in the l-word STV field of 
the FAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-55 lists control block fields that are input to the SEARCH 
operation, Table 5-56 lists control block fields that are output by 
the SEARCH operation. 


Table 5-55: SEARCH Input Fields 
a a ee es as 
Block Field Description 
a a ee 


ALL NXT Next XAB address 

DAT NXT Next XAB address 

FAB BPA Private buffer pool address 

FAB BPS Private buffer pool size (bytes) 
FAB FOP File processing option mask 


FBS RWO Rewind magtape before operation 
FBSRWC Rewind magtape after closing file 


FAB LCH Logical channel number 
FAB NAM NAM block address 
KEY NXT Next XAB address 


(Continued on next page) 
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Table 5-55 (Cont.): SEARCH Input Fields 


Block Field 


NAM 
NAM 
NAM 
NAM 
NAM 


Description 


Directory identifier 

Device identifier 

Expanded string buffer address 
Expanded string length (bytes) 
File specification mask 


NBSWCH Wildcard context established 


Resultant string buffer address 
Resultant string length (bytes) 
Resultant string buffer size (bytes) 
Wildcard context 

Wildcard directory context 

Next XAB address 

Next XAB address 


we a a 


Table 5-56: SEARCH Output Fields 


i 


Block Field 


Description 


a i 


FAB 
FAB 
NAM 
NAM 
NAM 


NAM 
NAM 
NAM 


STS 
STV 
DID 
FID 
FNB 


RSL 
wec 
WDI 


Device characteristic mask 


FBSCCL Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


Completion status code 
Completion status value 
Directory identifier 
File identifier 

File specification mask 


NBSWCH Wildcard context established 
Resultant string length (bytes) 


Wildcard context 
Wildcard directory context 
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5.29 $SPACE MACRO 


The SSPACE macro calls the SPACE operation routine to move a magtape 
backward or forward. 


FORMAT 
The format for the SSPACE is: 

SSPACE rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the SPACE operation. 
OPTIONS 


Internal Stream Identifier 

The SPACE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Spacing Interval 

Specify the number of blocks to move the magtape in the first word of 
the 2-word BKT field of the RAB. A positive number spaces forward; a 
negative number spaces backward. 

Asynchronous Operation 

If you want to execute the SPACE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the SPACE operation executes synchronously. (Your program 


must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


The readable-block context after a SPACE operation is the target 
block; the writable-block context after a SPACE operation is the 
target block. 


RETURNED VALUES 
Completion Status and Value 
The SPACE operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
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CHECKLISTS 


Table 5-57 lists control block fields that are input to the SPACE 
operation. Table 5-58 lists control block fields that are output by 
the SPACE operation, 


Table 5-57: SPACE Input Fields 


Pea a a eee 


Block Field Description 


i 


RAB BKT Virtual block number (VBN) increment 
RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


a 


Table 5-58: SPACE Output Fields 


wa 


Block Field Description 


a 


RAB sts Completion status code 
RAB STV Completion. status value 


a 
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5.30 S$TRUNCATE MACRO 

The S$TRUNCATE macro calls the TRUNCATE operation routine to remove 
records from the latter part of a sequential file; records are 
removed inclusively from the current record through the end-of-file. 
If the file cannot be truncated, the TRUNCATE operation returns an 


error completion and leaves the current-record context undefined and 
the next-record context unchanged. 


FORMAT 
The format for the STRUNCATE is: 
STRUNCATE rabaddr([, ferraddr][,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 


the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the TRUNCATE operation. 


OPTIONS 


Internal Stream Identifier 

The TRUNCATE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 

Asynchronous Operation 

If you want to execute the TRUNCATE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the TRUNCATE operation executes synchronously. (Your 


program must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


STREAM CONTEXT 


The TRUNCATE operation destroys the current-record context; the 
next-record context after the TRUNCATE operation is the end-of-file. 


RETURNED VALUES 


Completion Status and Value 


The TRUNCATE operation returns completion status in the 1l-word sts 
field of the RAB and returns a completion value in the l-word STV 
field of the RAB. Appendix A lists completion status symbols and 
values. 
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CHECKLISTS 


Table 5-59 lists control block fields that are input to the TRUNCATE 
operation. Table 5-60 lists control block fields that are output by 
the TRUNCATE operation. 


Table 5-59: TRUNCATE Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


Table 5-60: TRUNCATE Output Fields 


Block Field Description 


RAB STS Completion status code 
RAB STV Completion status value 
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5.31 S$UPDATE MACRO 
The SUPDATE macro calls the UPDATE operation routine to transfer a 
record from a user buffer to a disk file (overwriting the existing 
record). The target of the UPDATE operation is the current record, 
which is overwritten. 
If no record {as specified in the RAB) can be transferred, the UPDATE 
operation returns an error completion. 
FORMAT 
The format for the SUPDATE is: 

SUPDATE rabaddr[,[erraddr] [,sucaddr] } 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the UPDATE operation. 
OPTIONS 


Internal Stream Identifier 


The UPDATE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Record Buffer 


Specify the address of the record buffer in the l-word RBF field of 
the RAB, and specify the size (in bytes) of the record buffer in the 
l-word RSZ field of the RAB. For sequential files and for indexed 
files in which duplicate primary key values are permitted, the size of 
the buffer must be the same as the size of the existing record. 


If the file has VFC format, specify the address of the buffer for the 
VFC header in the l-word RHB field of the RAB; if you specify zero in 
this field, the existing record header will remain unchanged. 


Asynchronous Operation 


If you want to execute the UPDATE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the UPDATE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 


Bucket Fill Number Honoring 
If you want the UPDATE operation to honor bucket fill numbers for the 
file and its areas, set the RBSLOA mask in the l-word ROP field of the 


RAB. If you do not set this mask, the UPDATE operation fills buckets 
without regard to bucket fill numbers. 
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STREAM CONTEXT 
The UPDATE operation destroys the current-record context; the 
next-record context after the UPDATE operation is unchanged. 


RETURNED VALUES 


Completion Status and Value 

The UPDATE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 

Table 5-61 lists control block fields that are input to the UPDATE 


operation. Table 5-62 lists control block fields that are output by 
the UPDATE operation. 


Table 5-61: UPDATE Input Fields 


Block Field Description j 


RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB RHB VFC control buffer address 
RAB ROP Record processing option mask 


RBSASY Asynchronous operation 
RBSLOA Honor bucket fill numbers 


RAB RSZ Record size (bytes) 


a ee as A an ee cel 


Table 5-62: UPDATE Output Fields 


Block Field Description 


RAB sts Completion status code 
RAB STV Completion status value 
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5.32 SWAIT MACRO 

The S$WAIT macro calls the WAIT operation routine to suspend processing 
until an outstanding asynchronous operation on the stream is 
completed. The WAIT operation does not affect stream context. The 


WAIT operation cannot be used within any asynchronous operation's 
completion routine. 


FORMAT 
The format for the SWAIT is: 
SWAIT rabaddr 


where rabaddr is the address of the RAB for the operation. 


CONTROL BLOCKS 


You must supply a RAB for the WAIT operation. 


OPTIONS 


Internal Stream Identifier 


The WAIT operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


STREAM CONTEXT 
The WAIT operation does not affect stream context. The stream context 
after the WAIT operation is the context established by the outstanding 


asynchronous operation; if there is no outstanding asynchronous 
operation for the stream, the stream context is unchanged. 


RETURNED VALUES 


The WAIT operation returns no values. 
CHECKLISTS 


Table 5-63 lists control block fields that are input to the WAIT 
Operation. 


Table 5-63: WAIT Input Fields 


Block Field Description 


RAB ISI Internal stream identifier 
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5.33 SWRITE MACRO (SEQUENTIAL ACCESS) 


The SWRITE macro calls the WRITE operation routine to write blocks to 
a file. The target of a sequential-access WRITE operation is the 
writable block (and, for a multiblock WRITE operation, following 
blocks). 


FORMAT 
The format for the SWRITE is: 

SWRITE rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 


You must supply a RAB for the WRITE operation. 


OPTIONS 


Internal Stream Identifier 


The WRITE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Identification 


For a sequential-access WRITE operation, specify 0 in the 2-word BRT 
field of the RAB, 


Record Buffer 


Specify the address of the record buffer in the l-word RBF field of 
the RAB, and specify the size (in bytes) of the record buffer in the 
l-word RSZ field of the RAB. You must specify a record buffer for the 
WRITE operation; the WRITE operation transfers data from this buffer 
to the file. 


The WRITE operation normally updates the logical end-of-file marker, 
when appropriate, and automatically extends the file's allocation, 
when necessary. For sequential files with undefined (UDF) record 
format, however, the WRITE operation updates the logical end-of-file 
marker and performs automatic file extensions only if no write-sharing 
has been specified in the l-byte SHR field of the FAB. 


Asynchronous Operation 


If you want to execute the WRITE operation asynchronously, set the 
RBSASY mask in the l1-word ROP field of the RAB; if you do not set 
this mask, the WRITE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 
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STREAM CONTEXT 

The readable-block context after a WRITE operation is the block 


following the last-written block; the writable-block context after a 
WRITE. operation is the block following the last-written block. 


RETURNED VALUES 


Record File Address (RFA) 
The WRITE operation returns the virtual block number of the 
first-written block in the first two words of the 3-word RFA field of 
the RAB (it clears the third word). 
Completion Status and Value 
The WRITE operation returns completion status in the l-word STS field 
of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 
CHECKLISTS 
Table 5-64 lists control block fields that are input to the WRITE 
operation. Table 5-65 lists control block fields that are output by 
the WRITE operation. 

Table 5-64: WRITE (Sequential Access) Input Fields 


Block Field Description 


RAB BRKT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB RSZ Record size (bytes) 


Table 5-65: WRITE (Sequential Access) Output Fields 


Block Field Description 


RAB RFA Virtual block number (2 words) 
RAB STs Completion status code 
RAB STV Completion status value 
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5.34 S$WRITE MACRO (VBN ACCESS) 
The SWRITE macro calls the WRITE operation routine to write blocks to 
a file, The target of a VBN-access WRITE operation is the writable 
block (and, for a multiblock WRITE operation, following blocks). 
FORMAT 
The format for the SWRITE is: 

SWRITE rabaddr[,[erraddr] [,sucaddr] ] 
where rabaddr is the address of the RAB for the operation; erraddr is 
the address of the error handler for the operation; and sucaddr is 
the address of the success handler for the operation. 
CONTROL BLOCKS 


You must supply a RAB for the WRITE operation. 
OPTIONS 


Internal Stream Identifier 


The WRITE operation reads the internal stream identifier from the 
l-word ISI field of the RAB. 


Block Identification 


Specify the virtual block number of the first block to be written in 
the 2-word BKT field of the RAB. 


Record Buffer 


Specify. the address of the record buffer in the l-word RBF field of 
the RAB, and specify the size (in bytes) of the record buffer in the 
l-word RSZ field of the RAB. You must specify a record buffer for the 
WRITE operation; the WRITE operation transfers data from this buffer 
to the file. 


The WRITE operation normally updates the logical end-of-file marker, 
when appropriate, and automatically extends the file's allocation, 
when necessary. For sequential files with undefined (UDF) record 
format, however, the WRITE operation updates the logical end-of-file 
marker and performs automatic file extensions only if no write-sharing 
has been specified in the 1l-byte SHR field of the FAB. 


Asynchronous Operation 


If you want to execute the WRITE operation asynchronously, set the 
RBSASY mask in the 1l-word ROP field of the RAB; if you do not set 
this mask, the WRITE operation executes synchronously. (Your program 
must also have given the ASYN argument to the RABSB macro that 
declared the RAB for the asynchronous operation.) 
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STREAM CONTEXT 

The readable-block context after a WRITE operation is the block 


following the last-written block; the writable-block context after a 
WRITE operation is the block following the last-written block. 


RETURNED VALUES 


Record File Address (RFA) 
The WRITE operation returns the virtual block number of the 


first-written block in the first two words of the 3-word RFA field of 
the RAB (it clears the third word). 


Completion Status and Value 
The WRITE operation returns completion status in the l-word STS field 


of the RAB and returns a completion value in the l-word STV field of 
the RAB. Appendix A lists completion status symbols and values. 


CHECKLISTS 


Table 5-66 lists control block fields that are input to the WRITE 
Operation, Table 5-67 lists control block fields that are output by 
the WRITE operation. 


Table 5-66: WRITE (VBN Access) Input Fields 


Block Field Description 


RAB BRT Virtual block number (VBN) 
RAB ISI Internal stream identifier 
RAB RBF Record buffer address 

RAB ROP Record processing option mask 


RBSASY Asynchronous operation 


RAB RSZ Record size (bytes) 


Table 5-67: WRITE (VBN Access) Output Fields 


Block Field Description 


RAB RFA Virtual block number (2 words) 
RAB sts Completion status code 
RAB. STV Completion status value 
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CONTROL BLOCK FIELDS 


Each major section of this chapter describes an RMS-11 control block, 
and includes: 


e Block summary table 
A table summarizes the entire control block. The table shows 
the offset, offset symbol, field size, and a brief description 
of each field in the block; for each mask or code for a 
field, the table shows the value, symbol, and a brief 
description of the mask or code. 

e Field summaries 
Each subsection following the block summary table is a 
description of one field in the block. A field that has masks 
that are very different in purpose (such as the FOP field in 
the FAB) is described as a number of separate "fields" (such 
as FOP FBSFID, FOP FBSRWO, and so forth). 
The description of each field includes the following: 
USE: a summary of the purpose of the field 
SIZE: the size of the field 
INIT: the format of the field-initialization macro (if any) 


ACCESS: the formats of field-access macros to access the 
field 


MASKS or CODES: (if any) each mask or code symbol and a brief 
description 


INPUT: the operations that read values from the field, and 
the meanings of those values 


OUTPUT: the operations that store values in the field, and 
the meanings of those values 


Fields described as "Reserved" and undefined bits in masks should (and 
in some cases must) be 0. 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1 ALL BLOCK SUMMARY 

This section summarizes the ALL block and its fields. Table 6-1 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 


code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-1: ALL Block Summary 


Offset Field 
Offset Symbol Size Description 

000 OSCOD 1 byte ALL block identifier code 

000004 XBSALL ALL block identifier 
001 OSBLN 1 byte ALL block length (bytes) 

000034 XBSLAL ALL block length (bytes) 
002 OSNXT 
004 OSAID 
005 OSBKZ 


006 OSVOL 
010 OSALN 


word Next XAB address 

byte Area number 

byte Area bucket size (blocks) 
word Reserved 

byte Area alignment mask 


PRR P 


000002 XBSLBN Logical block alignment 
000004 XBSVBN Virtual block alignment 


oll OSAOP 1 byte Area option mask 


000001 XBSHRD Hard area location 
000002 xXBSCTG Contiguous area 
012 OSALQ 2 words Area allocation size (blocks) 
012 OSALQO0 1 word ALQ field low word 
014 OSALQ1 1 word ALQ field high word 
016 OSDEQ 1 word Area default extension size (blocks) 
020 1 word Reserved 
022 OSLOC 2 words Area location 
022 OSLOCO 1 word Loc field low word 
024 OSLOC1 1 word LOC field high word 


6.1.1 AID Field in ALL Block 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


Contains the area identifier for the area described by the 


ALL block. 


XSAID number 


1 byte 

SFETCH dst,AID,reg ;AID field to 1l-byte dst 
SSTORE src,AID,reg sl-byte src to AID field 
SCOMPARE src,AID,reg pl-byte sre with AID field 
CLOSE Area number 

CREATE Area number 

DISPLAY Area number 

EXTEND Area number 

OPEN Area number 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1.2 


USE 


INIT 
SIZE 


ACCESS 


MASKS 


INPUT 


OUTPUT 


ALN Field in ALL Block 


Indicates alignment for the area described by the 
block. 


XSALN mask 

1 byte 

SSET mask,ALN,reg 7;Mask bits on in ALN field 
SOFF mask,ALN,reg - ;Mask bits off in ALN field 
STESTBITS mask,ALN,reg ;Test mask bits in ALN field 
SFETCH dst,ALN,reg 7;ALN field to l-byte dst 
SSTORE src,ALN,reg jl-byte sre to ALN field 


SCOMPARE src,ALN,reg ;l-byte src with ALN field 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


CREATE Initial area alignment request 
EXTEND Area extension alignment request 
DISPLAY Area alignment mask (cleared) 
OPEN Area alignment mask (cleared) 


ALL 


6.1.3 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


ALQ Field in ALL Block 


Contains the allocation size for the area described by the 


ALL block. 


XSALO number 


2 words 

SFETCH dst,ALQ,reg sALQ field to 2-word dst 

SSTORE src,ALQ,reg ;2-word src to ALQ field 

SFETCH dst,ALQn,reg ;ALQ word n to l-word dst 

SSTORE src,ALQn,reg ;l-word src to ALQ word n 

SCOMPARE src,ALQn,reg ;l-word src with ALQ word n 

CREATE Initial area allocation request size (blocks) 

EXTEND Area allocation extension request size 
(blocks) 

CREATE Initial area allocation size (blocks) 

DISPLAY Unused area allocation size (blocks) 

EXTEND Area allocation extension actual size (blocks) 

OPEN Unused area allocation size (blocks) 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1.4 AOP Field in ALL Block (XBSCTG Mask) 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Indicates contiguity for the area 


block. 
XSAOP mask 
1 byte 


SSET mask,AOP,reg 

SOFF mask,AOP,reg 
STESTBITS mask,AOP,reg 
SFETCH dst,AOP,reg 
SSTORE src,AOP,reg 
SCOMPARE src,AOP,reg 


CREATE Contiguous 
EXTEND Contiguous 
DISPLAY Contiguous 
OPEN Contiguous 


sMask bits 
;Mask bits 
;Test mask 
;AOP field 


described by the 


on in AOP field 
off in AOP field 
bits in AOP field 
to l-byte dst 


;l-byte src to AOP field 
sl-byte src with AOP field 


area request 
area extension request 


area (cleared) 
area (cleared) 


ALL 


CONTROL BLOCK FIELDS 
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6.1.5 AOP Field in ALL Block (XBSHRD Mask) 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Indicates a demand for the requested location. 


XSAOP mask 


1 byte 


SSET mask,AOP,reg 
SOFF mask,AOP,reg 


*Mask bits on in AOP field 
*Mask bits off in AOP field 


STESTBITS mask,AOP,reg ;Test mask bits in AOP field 


SFETCH dst,AOP,reg sAOP field to l-byte dst 
SSTORE src,AOP,reg jl-byte sre to AOP field 
SCOMPARE src,AOP,reg ;1l-byte src with AOP field 
CREATE Area hard location request 

EXTEND Area extension hard location request 
DISPLAY Hard area location (cleared) 

OPEN Hard area location (cleared) 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1.6 BKZ Field in ALL Block 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the bucket size for the area described by the ALL 
block. 


XSBKZ number 


1 byte 

SFETCH dst,BKZ,reg ;BKZ field to l-byte dst 
SSTORE src,BKZ,reg ;l-byte sre to BKZ field 
SCOMPARE src,BKZ,reg ;l-byte sre with BKZ field 
CREATE Area bucket size (blocks) 

DISPLAY Area bucket size (blocks) 

OPEN Area bucket size (blocks) 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1.7 BLN Field in ALL Block (XBSLAL Code) 


USE Contains the length of the ALL block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1.8 COD Field in ALL Block (XBSALL Code) 


USE Contains the identifier for the ALL block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg ;COD field to 1-byte dst 


SCOMPARE src,COD,reg ;l-byte sre with COD field 


6.1.9 DEQ Field in ALL Block 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


Contains the default extension size for the area described 


by the ALL block. 


XSDEQ number 


1 word 
SFETCH dst,DEQ,reg ;DEQ field to l-word dst 
SSTORE src,DEQ,reg sl-word src to DEQ field 


SCOMPARE src,DEQ,reg ;l-word sre 


CREATE Area default extension 
DISPLAY Area default extension 


OPEN Area default extension 


with DEQ field 
size (blocks) 


size (blocks) 
size (blocks) 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1.10 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


LOC Field in ALL Block 


Contains the location of the area described by the ALL 
block. 


The meaning of the location depends on the ALN mask: a 
logical block number (if XBSLBN) or a virtual block number 
(if XBSVBN). 


XSLOC number 


2 words 

SFETCH dst,LOC,reg 3;LOC field to 2-word dst 
SSTORE src,LOC,reg 32-word src to LOC field 
SFETCH dst,LOCn,reg ;LOC word n to l-word dst 
SSTORE src,LOCn,reg ;l-word sre to LOC word n 
SCOMPARE src,LOCn,reg ;l-word sre with LOC word n 
CREATE Initial area location request 

EXTEND Area extension location request 


CONTROL BLOCK FIELDS 
ALL BLOCK SUMMARY 


6.1.11 NXT Field in ALL Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg ;NXT field to l-word dst 
SSTORE src,NXT,reg ;l-word src to NXT field 
SCOMPARE src,NXT,reg ;l-word sre with NxT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2 DAT BLOCK SUMMARY 


This section summarizes the DAT block and its fields. Table 6-2 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 
code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code, 


Table 6-2: DAT Block Summary 


Offset Field 
Offset Symbol Size Description 


000 OSCOD 1 byte DAT block*identifier code 


* ef 
Vv: 0000s aspen DAT block identifier 


rs 


001 OSBLN 1 byte DAT block length (bytes) 
000046 XBSDTL DAT block length (bytes) 


word Next XAB address 
word File revision number 
words File revision date 
File creation date 
words File expiration date 


words Reserved 
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6.2.1 BLN Field in DAT Block (XBSDTL Code) 


USE 
INIT 
SIZE 


ACCESS 


Contains the length of the DAT block. 
None 
1 byte 


SFETCH dst,BLN,reg ;BLN field to l-byte dst 
SCOMPARE src,BLN,reg sl-byte src with BLN field 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2.2 CDT Field in DAT Block 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


Contains the binary creation date for the file. The time 
value is a binary number in 100-nanosecond units offset 
from the system base date and time, which is 00:00 
o'clock, November 17, 1858 (the Smithsonian base date and 
time for the astronomical calendar). 


None 

4 words 

SFETCH dst,CDT,reg ;CDT field to 4-word dst 
DISPLAY File creation date 

OPEN File creation date 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2.3 COD Field in DAT Block (XBSDAT Code) 


USE Contains the identifier for the DAT block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg sCOD field to l-byte dst 


SCOMPARE src,COD,reg zl-byte src with COD field 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2.4 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


EDT Field in DAT Block 


Contains the expiration date for the file. The time value 
is a binary number in 100-nanosecond units offset from the 
system base date and time, which is 00:00 o'clock, 
November 17, 1858 (the Smithsonian base date and time for 
the astronomical calendar). 


None 

4 words 

SFETCH dst,EDT,reg 7EDT field to 4-word dst 
OPEN File expiration date 

DISPLAY File expiration date 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2.5 NXT Field in DAT Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst ,NXT,reg sNXT field to 1l-word dst 
SSTORE src,NXT,reg sl-word src to NXT field 
SCOMPARE src,NXT,reg sl-word src with NxT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address : 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2.6 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


RDT Field in DAT Block 


Contains the binary revision date for the file. The time 
value is a binary number in 100-nanosecond units offset 
from the system base date and time, which is 00:00 
o'clock, November 17, 1858 (the Smithsonian base date and 
time for the astronomical calendar). 


None 

4 words 

SFETCH dst,RDT,reg ;RDT field to 4-word dst 
DISPLAY File revision date 

OPEN File revision date 


CONTROL BLOCK FIELDS 
DAT BLOCK SUMMARY 


6.2.7 RVN Field in DAT Block 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


Contains the revision number (number of times closed) for 
the file. 


None 

1 word 

SFETCH dst,RVN,reg *RVN field to l-word dst 
SCOMPARE src,RVN,;reg :l-word src with RVN field 
DISPLAY File revision number 

OPEN File revision number 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3 FAB SUMMARY 


This section summarizes the FAB and its fields. Table 6-3 summarizes 
the entire block, giving the offset, offset symbol, size, and a brief 
description for each field; for a field that has mask or code 
symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-3: FAB Summary 


Offset Field 
Offset Symbol Size Description 


000 OSBID 1 byte FAB identifier 

000003 FBSBID FAB identification code 
ool OSBLN l byte FAB length (bytes) 

000120 FBSBLN FAB length (bytes) 


002 OSCTX 
004 OSIFI 
006 OSssTS 
010 OSSTV 
012 OSALQ 
016 OSDEQ 
020 OSFAC 


word User context 

word Internal file identifier 

word Completion status code 

Completion status value 

words File allocation size (blocks) 

word File default extension size (blocks) 
byte Requested access mask 


PEN PPE 
= 
° 
R 
Qu 


000001 FBSPUT Request put access 

000002 FBSGET Request find/get access 

000004 FBSDEL Request find/get/delete 
access 

000010 FBSUPD Request find/get/update 
access 

000020 FBSTRN Request find/get/truncate 
access 

000041 FBSWRT Request block write 
access 

000042 FBSREA Request block read access 


021 OSSHR 1 byte Shared access mask 


000002 FBSGET Share find/get access 

000015 FBSWRI Share find/get/put/update/ 
delete access 

000040 FBSUPI Share any access 
(user-provided interlock) 

000100 FBSNIL No access sharing 


(Continued on next page) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


Table 6-3 (Cont.): FAB Summary 


wl a a a 


Offset Field 
Offset Symbol Size Description 


a i ce rr 


022 OSFOP 1 word File processing option mask 


000001 FBSRWO Rewind magtape before 
operation 
000002 FBSRWC Rewind magtape after 
closing file 
000010 FBSPOS Position magtape after 
last-closed file 
000020 FBSDLK No file locking on 
abnormal close 
000200 FBSCTG Contiguous file 
000400 FBSSUP Supersede existing file 
001000 FBSNEF No end-of-file magtape 
positioning 
002000 FBSTMP Temporary file 
004000 FBSMKD Mark file for deletion 
006000 FBSTMD Temporary file, mark for 
deletion 
010000 FBSFID Use information in NAM 
block 
020000 FBSDFW Defer writing 


024 OSRTV 1 byte Retrieval pointer count 
025 OSORG 1 byte File organization code 


000000 FBSSEQ Sequential file 
organization 
000020 FBSREL Relative file 
: organization 
000040 FBSIDX Indexed file organization 


026 OSRAT 1 byte Record handling mask 


000001 FBSFTN FORTRAN-style 
carriage-control 
character in record 

000002 FBSCR Add CRLF to print record 
(LF-record-CR) 

000004 FBSPRN VFC print record handling 

000010 FBSBLK Blocked records 


027 OSREM 1 byte Record format code 


000000 FBSUDF Undefined record format 

‘000001 FBSFIX Fixed-length record 
format 

000002 FBSVAR Variable-length record 
format 

000003 FBSVFC VFC record format 

000004 FBSSTM Stream record format 


(Continued on next page) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


Table 6-3 (Cont.): FAB Summary 


Offset Field 
Offset Symbol Size Description 


030 OS XAB 
032 OSBPA 
034 OSBPS 
036 OSMRS 
040 OSMRN 
044 OSLRL 
046 OSNAM 
050 OSFNA 
052 OSDNA 
054 OSFNS 
055 OSDNS 
056 OSBLS 
060 OSFSZ 


word XAB address 

word Private buffer pool address 

word Private buffer pool size (bytes) 

word Maximum record size (bytes) 

words Maximum record number 

word Longest record length 

word NAM block address 

word File string address 

word Default string address 

byte File string size (bytes) 

byte Default string size (bytes) 

word Magtape block size (characters) 

byte Fixed control area size for VFC records 
(bytes) 

byte File bucket size (blocks) 

byte Device characteristic mask 


PREP RPP RBRPENBEEE 


061 OSBKS 
062 OSDEV 


Hh 


000001 FBSREC Record-oriented device 
000002 FBSCCL. Carriage-control device 
000004 FBSTRM Terminal device 

000010 FBSMDI Multidirectory device 
000020 FBSSDI Single-directory device 
000040 FBSSQD Sequential device 


063 OSLCH 1 byte Logical channel number 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.1 ALQ Field in FAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the allocation size for the file. 
FSALQ number 
2 words 


SFETCH dst,ALQ,reg s;ALQ field to 2-word dst 
SSTORE src,ALQ,reg ;2-word src to -ALQ field 
SFETCH dst,ALQn,reg 3;ALQ word n to l-word dst 
SSTORE src,ALQn,reg :l-word src to ALQ word n 
SCOMPARE src,ALQn,reg ;l-word sre with ALQ word n 


CREATE Initial file allocation request size (blocks) 
EXTEND File allocation extension request size 
(blocks) 


CREATE Initial file allocation size (blocks) 
EXTEND File allocation extension actual size (blocks) 
OPEN Current file allocation (blocks) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.2 BID Field in FAB (FBSBID Code) 


USE Contains the identifier for the FAB. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BID,reg ;BID field to l-byte dst 


SCOMPARE src,BID,reg ;l-byte sre with BID field 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.3 BKS Field in FAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the bucket size for the file. 


FSBKS number 


1 byte 

SFETCH dst,BKS,reg sBKS field to l-byte dst 
SSTORE src,BKS,reg :l-byte src to BKS field 
SCOMPARE src,BKS,reg :l-byte src with BKS field 
CREATE File bucket size (blocks) 

OPEN File bucket size (blocks) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.4 BLN Field in FAB (FBSBLN Code) 


USE Contains the length of the FAB. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte sre with BLN field 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.5 BLS Field in FAB 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the magtape block size for the file. 


FSBLS number 


1 word 

SFETCH dst,BLS,reg ;BLS field to l-word dst 
SSTORE src,BLS,reg :l-word src to BLS field 
SCOMPARE src,BLS,reg sl-word sre with BLS field 
CREATE ‘Magtape block size (characters) 

OPEN Magtape block size (characters) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.6 BPA Field in FAB 


USE Contains the address of the private buffer pool for the 
operation. 
INIT FSBPA address 
SIZE 1 word 
ACCESS _ SFETCH dst,BPA,reg ;BPA field to l-word dst 
SSTORE src,BPA,reg ;l-word sre to BPA field 
SCOMPARE src,BPA,reg ;l-word src with BPA field 
INPUT CREATE Private buffer pool address 
ENTER Private buffer pool address 
ERASE Private buffer pool address 
OPEN Private buffer pool address 
PARSE Private buffer pool address 
REMOVE Private buffer pool address 
RENAME Private buffer pool address 
SEARCH Private buffer pool address 
OUTPUT CLOSE Private buffer pool address 


6-30 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.7 BPS Field in FAB 


USE Contains the size of the private buffer pool for the 
operation. 

INIT FSBPS number 

SIZE 1 word 

ACCESS SFETCH dst,BPS,reg sBPS field to l-word dst 
SSTORE src,BPS,reg sl-word src to BPS field 
SCOMPARE src,BPS,reg sl-word src with BPS field 

INPUT CREATE Private buffer pool size (bytes) 
ENTER Private buffer pool size (bytes) 
ERASE Private buffer pool size (bytes) 
OPEN Private buffer pool size (bytes) 
PARSE Private buffer pool size (bytes) 
REMOVE Private buffer pool size (bytes) 
RENAME Private buffer pool size (bytes) 
SEARCH Private buffer pool size (bytes) 

OUTPUT CLOSE Private buffer pool size (bytes) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.8 CTX Field in FAB 


USE Contains any information you may want to associate with 
the file at run time. 


INIT FSCTX number 

SIZE 1 word 

ACCESS SFETCH dst,CTX,reg ;CTX field to l-word dst 
SSTORE src,CTX,reg ;l-word sre to CTX field 


SCOMPARE src,CTX,reg ;l-word sre with CTX field 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.9 DEQ Field in FAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the default extension size for the file. 


FSDEQ number 


1 word 

SFETCH dst,DEQ,reg ;DEQ field to l-word dst 

SSTORE src,DEQ,reg sl-word sre to DEQ field 

SCOMPARE src,DEQ,reg :l-word sre with DEQ field 

CREATE Permanent file default extension size (blocks) 

OPEN While-open file default extension size 
(blocks) 

OPEN Current file default extension size (blocks) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.10 DEV Field in FAB 


USE Indicates device characteristics for the file. 

INIT None 

SIZE 1 byte 

ACCESS STESTBITS mask,DEV,reg ;Test mask bits in DEV field 
SFETCH dst,DEV,reg ;DEV field to l-byte dst 


SCOMPARE src,DEV,reg ;l-byte sre with DEV field 


MASKS FBSCCL. Carriage-control device 
FBSMDI Multidirectory device 
FBSREC Record-oriented device 
FBSSDI Single-directory device 
FBSSQD Sequential device 
FBSTRM Terminal device 


OUTPUT CREATE Device characteristic mask 
ENTER Device characteristic mask 
ERASE Device characteristic mask 
OPEN Device characteristic mask 
PARSE Device characteristic mask 
REMOVE Device characteristic mask 
RENAME Device characteristic mask 
SEARCH Device characteristic mask 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.11 DNA Field in FAB 


USE Contains the address of the default string for the 
operation. 
INIT FSDNA address 
SIZE 1 word 
ACCESS SFETCH dst ,DNA,reg ;DNA field to 1-word dst 
SSTORE src,DNA,reg :l-word sre to DNA field 
SCOMPARE src,DNA,reg :l-word sre with DNA field 
INPUT CREATE Default string address 
ENTER Default string address 
ERASE Default string address 
OPEN Default string address 
PARSE Default string address 
REMOVE Default string address 
RENAME Default string address 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.12 DNS Field in FAB 


USE Contains the size of the default string for the operation. 
INIT FSDNS number 
SIZE 1 byte 
ACCESS SFETCH dst,DNS,reg ;DNS field to l-byte dst 
SSTORE src,DNS,reg ;l-byte sre to DNS field 
SCOMPARE src,DNS,reg jl-byte sre with DNS field 
INPUT CREATE Default string size (bytes) 
ENTER Default string size (bytes) 
ERASE Default string size (bytes) 
OPEN Default string size (bytes) 
PARSE Default string size (bytes) 
REMOVE Default string size (bytes) 
RENAME Default string size (bytes) 


6.3.13 
USE 
INIT 


SIZE 


ACCESS 


MASKS 


INPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


FAC Field in FAB 


Indicates the requested access for the file. 


FSFAC mask 

1 byte 

SSET mask,FAC,reg ;Mask bits on in FAC field 
SOFF mask,FAC,reg ;Mask bits off in FAC field 
STESTBITS mask,FAC,reg ;Test mask bits in FAC field 
SFETCH dst,FAC,reg ;FAC field to l-byte dst 
SSTORE src,FAC,reg ;l-byte src to FAC field 
SCOMPARE src,FAC,reg ;l-byte sre with FAC field 
FBSDEL Request find/get/delete access 

FBSGET Request find/get access 

FBSPUT Request put access 

FBSREA Request block read access. 

FBSTRN Request find/get/truncate access 

FBSUPD Request find/get/update access 

FBSWRT Request block write access 

CREATE Requested access mask 

OPEN Requested access mask 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.14 FNA Field in FAB 


USE Contains the address of the file string for the file. 
INIT FSFNA address 
SIZE 1 word 
ACCESS SFETCH dst,FNA,reg 3;FNA field to l-word dst 
SSTORE src,FNA,reg ;l-word sre to FNA field 
SCOMPARE src,FNA,reg sl-word sre with FNA field 
INPUT CREATE File string address 
ENTER File string address 
ERASE File string address 
OPEN File string address 
PARSE File string address 
REMOVE File string address 
RENAME File string address 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.15 FNS Field in FAB 


USE Contains the size of the file string for the file. 
INIT FSFNS number 
SIZE 1 byte 
ACCESS SFETCH dst,FNS,reg ;FNS field to l-byte dst 
SSTORE src,FNS,reg ;l-byte sre to FNS field 
SCOMPARE src,FNS,reg ;l-byte src with FNS field 
INPUT CREATE File string size (bytes) 
ENTER File string size (bytes) 
ERASE File string size (bytes) 
OPEN File string size (bytes) 
PARSE File string size (bytes) 
REMOVE File string size (bytes) 
RENAME File string size (bytes) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.16 FOP Field in FAB (FBSCTG Mask) 


USE Indicates file contiguity. 

INIT FSFOP mask 

SIZE 1 word 

ACCESS SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg 3;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg jl-word src to FOP field 
SCOMPARE src,FOP,reg ;l-word src with FOP field 

INPUT CREATE Contiguous file request 
EXTEND Contiguous file extension request 

OUTPUT OPEN Contiguous file 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.17 FOP Field in FAB (FBSDFW Mask) 


USE Requests deferred writing for the file. 

INIT FSFOP mask 

SIZE 1 word 

ACCESS SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg sMask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg sl-word sre to FOP field 
SCOMPARE src,FOP,reg ;l-word src with FOP field 

INPUT CREATE Defer writing 
OPEN Defer writing 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.18 FOP Field in FAB (FBSDLK Mask) 


USE Requests no file locking if the file is closed abnormally. 

INIT FSFOP mask 

SIZE 1 word 

ACCESS SSET mask,FOP,reg sMask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word sre to FOP field 
SCOMPARE src,FOP,reg ;l-word src with FOP field 

INPUT CREATE No file locking on abnormal close 
OPEN No file locking on abnormal close 


6.3.19 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


FOP Field in FAB (FBSFID Mask) 


Requests that NAM block information be used to identify 


the file. 

FSFOP mask 

1 word 

SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg sMask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg :l-word sre to FOP field 
SCOMPARE src,FOP,reg ;l-word sre with FOP field 
CREATE Use information in NAM block 

ENTER Use information in NAM block 

ERASE Use information in NAM block 

OPEN Use information in NAM block 

REMOVE Use information in NAM block 

RENAME Use information in NAM block 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.20 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


FOP Field in FAB (FBSMKD Mask) 


Requests that the file be marked for deletion. 


FSFOP mask 

1 word 

SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg sl-word sre to FOP field 


SCOMPARE src,FOP,reg sl-word src with FOP field 


CREATE Mark file for deletion 


6.3.21 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


FOP Field in FAB (FBSNEF Mask) 


Requests that the magtape file 


beginning of the file. 
FSFOP mask 
1 word 


SSET mask,FOP,reg sMask bits 
SOFF mask,FOP,reg sMask bits 
STESTBITS mask,FOP,reg ;Test mask 
SFETCH dst,FOP,reg ;FOP field 
SSTORE src,FOP,reg 

SCOMPARE src,FOP,reg 


OPEN 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


be positioned to the 


on in FOP field 
off in FOP field 
bits in FOP field 
to l-word dst 


sl-word src to FOP field 
sl-word sre with FOP field 


No end-of-file magtape positioning 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.22 FOP Field in FAB (FBS$POS Mask) 


USE Requests that the magtape be positioned to the end of 
last-closed file before creating the new file. 

INIT FSFOP mask 

SIZE 1 word 

ACCESS SSET mask,FOP,reg :Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg 7;FOP field to l-word dst 
SSTORE src,FOP,reg ;il-word src to FOP field 


SCOMPARE src,FOP,reg ;l-word sre with FOP field 


INPUT CREATE Position magtape after last-closed file 


the 


6.3.23 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


FOP Field in FAB (FBSRWC Mask) 


Requests that the magtape be rewound when the file is 
closed. 


FSFOP mask 

1 word 

SSET mask,FOP,reg ;Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word sre to FOP field 
SCOMPARE src,FOP,reg ;l-word src with FOP field 
CLOSE Rewind magtape after closing file 
CREATE Rewind magtape after closing file 

OPEN Rewind magtape after closing file 
SEARCH Rewind magtape after closing file 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.24 FOP 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


Field in FAB (FBSRWO Mask) 


Reguests that the magtape be rewound before the operation. 


FSFOP mask 

1 word 

SSET mask,FOP,reg *Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word src to FOP field 
SCOMPARE src,FOP,reg ;l-word src with FOP field 
CREATE Rewind magtape before creating file 
OPEN Rewind magtape before searching for file 
SEARCH Rewind magtape before operation 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.25 FOP Field in FAB (FBSSUP Mask) 


USE Requests that the created file supersede the old file with 
the same specification (if one exists). 

INIT FSFOP mask 

SIZE 1 word 

ACCESS SSET mask,FOP,reg © ;Mask bits on in FOP field 
SOFF mask,FOP,reg sMask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word sre to FOP field 


SCOMPARE src,FOP,reg ;l-word sre with FOP field 


INPUT CREATE Supersede existing file 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.26 FOP 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


Field in FAB (FBSTMP Mask) 


Requests that the created file be 
with no directory entry). 


a temporary file 


FSFOP mask 

1 word 

SSET mask,FOP,reg 7Mask bits on in FOP field 
SOFF mask,FOP,reg ;Mask bits off in FOP field 
STESTBITS mask,FOP,reg ;Test mask bits in FOP field 
SFETCH dst,FOP,reg ;FOP field to l-word dst 
SSTORE src,FOP,reg ;l-word sre to FOP field 


SCOMPARE src,FOP,reg ;l-word sre with FOP field 


CREATE Temporary file 


(one 


6.3.27 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


FSZ Field in FAB 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


Contains the size of the fixed control area for VEC 

records. 

FSFSZ number 

1 byte 

SFETCH dst,FSZ,reg ;FSZ field to l-byte dst 

SSTORE src,FSZ,reg z;l-byte sre to FSZ field 

SCOMPARE src,FSZ,reg sl-byte src with FSZ field 

CREATE Fixed control area size for VFC records 
(bytes) 

OPEN Fixed control area size for VEC records 
(bytes) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.28 IFI Field in FAB 


USE Contains the internal file identifier for the file. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,IFI,reg ;IFI field to l-word dst 
SCOMPARE src,IFI,reg ;l-word sre with IFI field 
INPUT CLOSE Internal file identifier 
CONNECT Internal file identifier 
DISPLAY Internal file identifier 
EXTEND Internal file identifier 
OUTPUT CLOSE Internal file identifier 
CREATE Internal file identifier 
OPEN Internal file identifier 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.29 LCH Field in FAB 


USE Contains the logical channel number for the operation. 
INIT FSLCH number 
SIZE 1 byte 
ACCESS SFETCH dst,LCH,reg ;LCH field to l-byte dst 
SSTORE src,LCH,reg © :1-byte src to LCH field 
SCOMPARE src,LCH,reg tl-byte src with LCH field 
INPUT CREATE Logical channel number 
ENTER Logical channel number 
ERASE Logical channel number 
OPEN Logical channel number 
PARSE Logical channel number 
REMOVE Logical channel number 
RENAME Logical channel number 
SEARCH Logical channel number 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.30 LRL 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Field in FAB 


Contains the length of the longest record in a sequential 


file. 
None 
1 word 


SFETCH dst,LRL,reg ;LRL field to l-word dst 
SCOMPARE src,LRL,reg ;l-word src with LRL field 


CREATE Longest record length (block access 
sequential files only) 


OPEN Longest record length 


to 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.31 MRN Field in FAB 


USE Contains the maximum record number allowed in a _ relative 
INIT FSMRN number 
SIZE 2 words 
ACCESS SFETCH dst,MRN,reg ;MRN field to 2-word dst 
SSTORE src,MRN,reg ;2-word src to MRN field 
SFETCH dst,MRNn,reg ;MRN word n to l-word dst 
SSTORE src,MRNn,reg ;l-word src to MRN word n 
SCOMPARE src,MRNn,reg j;l-word src with MRN word n 
INPUT CREATE Maximum record number 
OUTPUT OPEN Maximum record number 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.32 MRS 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Field in FAB 


Contains the record size for fixed-length records or 
maximum record size for other format records for the file. 


FSMRS number 


1 word 

SFETCH dst,MRS,reg *MRS field to l-word dst 
SSTORE src,MRS,reg ;l-word sre to MRS field 
SCOMPARE src,MRS,reg ;l-word sre with MRS field 
CREATE Maximum record size (bytes) 

OPEN Maximum record size (bytes) 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.33 NAM Field in FAB 


USE Contains the address of the NAM block for the operation. 
INIT FSNAM address 
SIZE 1 word 
ACCESS SFETCH dst,NAM,reg 3;NAM field to l-word dst 
SSTORE src,NAM,reg sl-word src to NAM field 
SCOMPARE src,NAM,reg sl-word sre with NAM field 
INPUT CREATE NAM block address 
ENTER NAM block address 
ERASE NAM block address 
OPEN NAM block address 
PARSE NAM block address 
REMOVE NAM block address 
RENAME NAM block address. 
SEARCH NAM block address 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.34 ORG 


USE 


INIT 


SIZE 


ACCESS 


CODES 


INPUT 


OUTPUT 


Field in FAB 


Contains the file organization code. 


FSORG code 

1 byte 

SFETCH dst,ORG,reg ;ORG field to l-byte dst 
SSTORE src,ORG,reg ;l-byte src to ORG field 


SCOMPARE src,ORG,reg ;l-byte src with ORG field 
FBSIDX Indexed file organization 

FBSREL Relative file organization 

FBSSEQ Sequential file organization 

CREATE File organization code 


OPEN File organization code 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.35 RAT Field in FAB 


USE Indicates the record-output characteristic for the file. 
(The RAT field also contains the record-blocking 
characteristic, which is described in the next section.) 


INIT FSRAT mask 

SIZE 1 byte 

ACCESS SSET mask,RAT,reg ;Mask bits on in RAT field 
SOFF mask,RAT,reg sMask bits off in RAT field 
STESTBITS mask,RAT,reg ;Test mask bits in RAT field 
SFETCH dst,RAT,reg sRAT field to 1l-byte dst 
SSTORE src,RAT,reg ;1l-byte src to RAT field 


SCOMPARE src,RAT,reg sl-byte sre with RAT field 

MASKS FBSCR Add CRLF to print record (LF-record-CR) 
FBSFTN FORTRAN-style carriage-control character in record 
FBSPRN VFC print record handling 

INPUT CREATE Record handling mask 


OUTPUT OPEN Record handling mask 


CONTROL BLOCK FIELDS 


FAB SUMMARY 


6.3.36 RAT 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Field in FAB (FBSBLK Mask) 


Indicates whether the file has blocked records. (The RAT 
field also contains the record-output characteristic, 
which is described in the previous section.) 


FSRAT mask 


1 byte 

SSET mask,RAT,reg 7Mask bits on in RAT field 
SOFF mask,RAT,reg ;Mask bits off in RAT field 
STESTBITS mask,RAT,reg ;Test mask bits in RAT field 
SFETCH dst,RAT,reg ;RAT field to l-byte dst 
SSTORE src,RAT,reg ;l-byte sre to RAT field 
SCOMPARE src,RAT,reg ;l-byte src with RAT field 
CREATE Blocked records 

OPEN Blocked records 


6.3.37 


USE 
INIT 
SIZE 


ACCESS 


CODES 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


REM Field in FAB 


Contains the record format code for the file. 


FSREFM code 


1 byte 
SFETCH dst,RFM,reg ;RFM field to l-byte dst 
SSTORE src,RFM,reg :l-byte src to RFM field 


SCOMPARE src,RFM,reg zl-byte src with RFM field 


FBSFIX Fixed-length record format 
FBSSTM Stream record format 

FBSUDF Undefined record format 
FBSVAR Variable-length record format 
FBSVEC VFC record format 


CREATE Record format code 


OPEN Record format code 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.38 RTV Field in FAB 


USE Contains the retrieval pointer count for the file. 
INIT FSRTV number 
SIZE 1 byte 
ACCESS SFETCH dst,RTV,reg ;RTV field to l-byte dst 
SSTORE src,RTV,reg ;l-byte src to RTV field 
SCOMPARE src,RTV,reg ;l-byte sre with RTV field 
INPUT CREATE Retrieval pointer count 
OPEN Retrieval pointer count 


6-62 


6.3.39 


USE 


INIT 


SIZE 


ACCESS 


MASKS 


INPUT 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


SHR Field in FAB 


Indicates requested access sharing for the file. 


FSSHR mask 


1 byte 


SSET mask,SHR,reg sMask bits on in SHR field 
SOFF mask,SHR,reg ;Mask bits off in SHR field 
STESTBITS mask,SHR,reg ;Test mask bits in SHR field 
SFETCH dst,SHR,reg ;SHR field to l-byte dst 
SSTORE src,SHR,reg --¢l-byte sre to SHR field 
SCOMPARE src,SHR,reg zl-byte src with SHR field 


FBSGET 
FBSNIL 
FBSUPI 
FBSWRI 


CREATE 
OPEN 


Share find/get access 

No access sharing 

Share any access (user-provided interlock) 
Share find/get/put/update/delete access 


Shared access mask 
Shared access mask 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.40 STS Field in FAB 


USE Contains the completion status code for the operation. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,STS,reg 3;8TS field to l-word dst 
SCOMPARE src,STS,reg z;l-word sre with STS field 
OUTPUT CLOSE Completion status code 
CREATE Completion status code 
DISPLAY Completion status code 
ENTER Completion status code 
ERASE Completion status code 
EXTEND Completion status code 
OPEN Completion status code 
PARSE Completion status code 
REMOVE Completion status code 
RENAME Completion status code 
SEARCH Completion status code 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.41 STV Field in FAB 


USE Contains the completion status value for the operation. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,STV,reg sSTV field to l-word dst 
SCOMPARE src,STV,reg zl-word sre with STV field 
OUTPUT CLOSE Completion status value 
CREATE Completion status value 
DISPLAY Completion status value 
ENTER Completion status value 
ERASE Completion status value 
EXTEND Completion status value 
OPEN . Completion status value 
PARSE Completion status value 
REMOVE Completion status value 
RENAME Completion status value 
SEARCH Completion status value 


CONTROL BLOCK FIELDS 
FAB SUMMARY 


6.3.42 XAB Field in FAB 


USE Contains the address of the first XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 


INIT FSXAB address 
SIZE 1 word 


ACCESS SFETCH dst,XAB,reg ;XAB field to l-word dst 
SSTORE src,XAB,reg ;l-word sre to XAB field 
SCOMPARE src,XAB,reg ;l-word sre with XAB field 


INPUT CLOSE XAB address 
CREATE XAB address 
DISPLAY XAB address 
EXTEND XAB address 
OPEN XAB address 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4 KEY BLOCK SUMMARY 


This section summarizes the KEY block and its fields. Table 6-4 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 
code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-4: KEY Block Summary 


a 


Offset Field 
Offset Symbol Size Description 


i 


000 OSCOD 1 byte KEY block identifier code 
000001 XBSKEY KEY block identifier 
001 OSBLN 1 byte KEY block length (bytes) 
000070 XBSKYL KEY block length (bytes) 


002 OSNXT 1 word Next XAB address 

004 OSREF 1 byte Index reference number 

005 OSLVL 1 byte Number of index levels (not including 
data level) 

word Index bucket fill factor 

word Data bucket fill factor 

byte Null key character 

byte Higher level index area number 

byte Lowest index level area number 

byte ‘Data area number 

byte Index option mask 


006 OSIFL 
010 OSDFL 
012 OSNUL 
013 OSIAN 
014 OSLAN 
015 OSDAN 
016 OSFLG 


PR RPE RPE 


000001 XBSDUP Duplicate record keys 
allowed 

000002 XBSCHG Record key changes 
allowed on update 

000020 XBSINI No entries yet made in 
index 

000004 xXBSNUL Null record keys not 
indexed 


017 OSDTP 1 byte Key data type code 


000000 xXBSSTG String 

000001 XBSIN2 15-bit signed integer 
000002 XBSBN2 16-bit unsigned integer 
000003 XBSIN4 31-bit signed integer 
000004 XBSBN4 32-bit unsigned integer 
000005 xXBSPAC Packed decimal number 


(Continued on next page) 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


Table 6-4 (Cont.): KEY Block Summary 


Offset Field 
Offset Symbol Size Description 


020 OSKNM 
022 OSPOS 
022 OSPOSO 
024 OSPOS1 


word Key name buffer address 
words Key segment positions 

word Key segment 0 position 
word Key segment 1 position 


026 OSPO0S2 word Key segment position 
030 OSPOS3 word Key segment position 
032 OSPOS4 word Key segment position 
034 OSPOS5 word Key segment position 
036 OSPOS6 word Key segment position 
040 OSPOS7 word Key segment position 


042 OSSIZ 

042 -OSSIZ0 
043 OSSIZ1 
044 OSSIZ2 
045 OSS1Z3 
046 OSSIZ4 
047 OSSIZ5 
050 OSSIZ6 
051 OS$SIZ7 


bytes Key segment 
byte Key segment 
byte Key segment 
byte Key segment 
byte Key segment 
byte Key segment 
byte Key segment 
byte Key segment 
byte Key segment 


izes (bytes) 

size (bytes) 
size (bytes) 
size (bytes) 
size (bytes) 
size (bytes) 
size (bytes) 
size (bytes) 
size (bytes) 


PREP HEN NEP PREP EPP PORE EP RPP PEP oF 
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052 OSRVB words Root index bucket virtual block number 

056 OSDVB words First data bucket virtual block number 

062 OSIBS byte Index area bucket size (blocks) 

063 OSDBS byte Data area bucket size (blocks) 

064 OSNSG byte Key segment count 

065 OSTKS byte Total key size (sum of key segment sizes) 
(bytes) 

066 OSMRL 1 word Minimum length of record containing key 
(bytes) 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.1 BLN Field in KEY Block (XBSKYL Code) 


USE Contains the length of the KEY block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte sre with BLN field 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.2 COD Field in KEY Block: (XBSKEY Code) 


USE Contains the identifier for the KEY block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg ;COD field to l-byte dst 


SCOMPARE src,COD,reg zl-byte sre with COD field 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.3 DAN Field in KEY Block 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the area number of the data area for the index 
described by the KEY block. 


XSDAN number 


1 byte 

SFETCH dst,DAN,reg ;DAN field to l-byte dst 
SSTORE src,DAN,reg ;l-byte sre to DAN field 
SCOMPARE src,DAN,reg ;l-byte src with DAN field 
CREATE Data area number 

DISPLAY Data area number 

OPEN Data area number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.4 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


DBS Field in KEY Block 


Contains the bucket size for the data area for the 
described by the KEY block. 


None 

1 byte 

SFETCH dst,DBS,reg ;DBS field to 1l-byte dst 
SCOMPARE src,DBS,reg ;l-byte src with DBS field 
DISPLAY Data area bucket size (blocks) 

OPEN Data area bucket size (blocks) 


index 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.5 DFL Field in KEY Block 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains the bucket fill number for the data area for the 
index described by the KEY block. 


XSDFL number 


1 word 

SFETCH dst,DFL,reg sDFL field to l-word dst 
SSTORE src,DFL,reg sl-word src to DFL field 
SCOMPARE src,DFL,reg sl-word sre with DFL field 
CREATE Data bucket fill factor 

DISPLAY Data bucket fill factor 

OPEN Data bucket fill factor 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.6 DTP Field in KEY Block 


USE Contains the key data type code for the index described by 
the KEY block. 

INIT XSDTP code 

SIZE 1 byte 

ACCESS SFETCH dst,DTP,reg ;DTP field to 1l-byte dst 
SSTORE src,DTP,reg jl-byte src to DTP field 


SCOMPARE src,DTP,reg ;l-byte sre with DTP field 


CODES XBSBN2 16-bit unsigned integer 
XBSBN4 32-bit unsigned integer 
XBSIN2 15-bit signed integer 
XBSIN4 31-bit signed integer 
XBSPAC Packed decimal number 
XBSSTG String 


INPUT CREATE Key data type code 
OUTPUT DISPLAY Key data type code 
OPEN Key data type code 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.7 DVB Field in KEY Block 


USE 


INIT 


SIZE 


ACCESS 


OUTPUT 


Contains the virtual block number of the first bucket in 
the data area for the index described by the KEY block. 


None 

2 words 

SFETCH dst,DVB,reg ;DVB field to 2-word dst 
DISPLAY First data bucket virtual block number 
OPEN First data bucket virtual block number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.8 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


FLG Field in KEY Block (XBSCHG Mask) 


Specifies that a record key (for an alternate index) 


allowed to change when the record 


is updated. 


XSFLG mask 

1 byte 

SSET mask,FLG,reg ;Mask bits on in FLG field 
SOFF mask,FLG,reg ;Mask bits off in FLG field 
STESTBITS mask,FLG,reg ;Test mask bits in FLG field 
SFETCH dst,FLG,reg ;FLG field to l-byte dst 
SSTORE src,FLG,reg ;l-byte src to FLG field 
SCOMPARE src,FLG,reg ;l-byte sre with FLG field 
CREATE Record key changes allowed on update 
DISPLAY Record key changes allowed on update 
OPEN Record key changes allowed on update 


is 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.9 FLG Field in KEY Block (XBSDUP Mask) 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Indicates that duplicate record keys are allowed for the 
index described by the KEY block; duplicate record keys 
are not allowed in the primary index. 


XSFLG mask 

1 byte 

SSET mask,FLG,reg *Mask bits on in FLG field 
SOFF mask,FLG,reg sMask bits off in FLG field 
STESTBITS mask,FLG,reg ;Test mask bits in FLG field 
SFETCH dst,FLG,reg ;FLG field to 1l-byte dst 
SSTORE src,FLG,reg sl-byte src to FLG field 
SCOMPARE src,FLG,reg ;l-byte src with FLG field 
CREATE Duplicate record keys allowed 

DISPLAY Duplicate record keys allowed 

OPEN Duplicate record keys allowed 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.10 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


FLG Field in KEY Block (XBSNUL Mask) 


Indicates that records containing only null characters are 
not contained in the index described by the KEY block. 
(The null character is specified in the NUL field of the 
KEY block.) 


XSFLG mask 


1 byte 

SSET mask,FLG,reg 7Mask bits on in FLG field 
SOFF mask,FLG,reg 7Mask bits off in FLG field 
STESTBITS mask,FLG,reg ;Test mask bits in FLG field 
SFETCH dst,FLG,reg ;FLG field to 1l-byte dst 
SSTORE src,FLG,reg ;l-byte src to FLG field 
SCOMPARE src,FLG,reg zl-byte sre with FLG field 
CREATE Null record keys not indexed 

DISPLAY Null record keys not indexed 

OPEN Null record keys not indexed 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.11 IAN Field in KEY Block 


USE Contains the area number of the area containing the higher 
index levels (all except the lowest level) for the index 
described by the KEY block. 


INIT XSIAN number 

SIZE 1 byte 

ACCESS SFETCH dst,IAN,reg ;IAN field to l-byte dst 
SSTORE src,IAN,reg s;l-byte src to IAN field 
SCOMPARE src,IAN,reg ;l-byte. src with IAN field 

‘INPUT CREATE Higher level index area number 

OUTPUT DISPLAY Higher level index area number 
OPEN Higher level index area number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.12 IBS Field in KEY Block 


USE Contains the bucket size of the area containing the index 
described by the KEY block. 


INIT None 
SIZE 1 byte 
ACCESS SFETCH dst,IBS,reg 7IBS field to l-byte dst 
SCOMPARE src,IBS,reg ;l-byte sre with IBS field 
OUTPUT DISPLAY Index area bucket size (blocks) 
OPEN Index area bucket size (blocks) 


6.4.13 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


IFL Field in KEY Block 


Contains the bucket fill number for the area containing 
the index described by the KEY block. 


XSIFL number 


1 word 

SFETCH dst,IFL,reg ;IFL field to l-word dst 
SSTORE src,IFL,reg :l-word sre to IFL field 
SCOMPARE src,IFL,reg zl-word sre with IFL field 
CREATE Index bucket fill factor 

DISPLAY Index bucket fill factor 

OPEN Index bucket fill factor 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.14 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


KNM Field in KEY Block 


Contains the address of the 32-byte key name buffer 
the index described by the KEY block. 


XSKNM address 


1 word 

SFETCH dst,KNM,reg ;KNM field to l-word dst 
SSTORE src,KNM,reg ;l-word sre to KNM field 
SCOMPARE src,KNM,reg ;l-word. sre with KNM field 
CREATE Key name buffer address 

DISPLAY Key name buffer address 

OPEN Key name buffer address 


for 


6.4.15 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


LAN Field in KEY 


Contains the 
lével of the 


XSLAN number 


1 byte 


SFETCH dst,LAN,reg 
SSTORE src,LAN,reg 
SCOMPARE src,LAN,reg 


CREATE 


DISPLAY 
OPEN 


Block 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


area number of the area containing the lowest 
index described by the KEY block. 


Lowest index level 


Lowest index level 
Lowest index level 


;LAN field to 1l-byte dst 
;l-byte 
;i-byte 


src to LAN field 
src with LAN field 


area number 


area number 
area number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.16 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


LVL Field in KEY Block 


Contains the number of levels (not including the data 
level) for the index described by the KEY block. 


None 

1 byte 

SFETCH dst,LVL,reg ;LVL field to l-byte dst 

SCOMPARE src,LVL,reg ;l-byte sre with LVL field 

DISPLAY Number of index levels (not including data 
level) 

OPEN Number of index levels (not including data 
level) 


6.4.17 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


MRL Field in KEY Block 


Contains the length of the smallest record that is long 
enough to completely contain a record key for the index 
described by the KEY block. 


None 

1 word 

SFETCH dst,MRL,reg sMRL field to l-word dst 

SCOMPARE src,MRL,reg :l-word sre with MRL field 

DISPLAY Minimum length of record containing key 
(bytes) 

OPEN Minimum length of record containing key 
(bytes) 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.18 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


NSG Field in KEY Block 


Contains the number of key segments in the key for 
index described by the KEY block. 


None 

1 byte 

SFETCH dst,NSG,reg ;NSG field to 1l-byte dst 
SCOMPARE src,NSG,reg ;l-byte sre with NSG field 
DISPLAY Key segment count 

OPEN Key segment count 


16-86 | 


the 


6.4.19 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


NUL Field in KEY Block 


Contains the null character for the (alternate) index 
described by the KEY block. For a string key (XBSSTG in 
the DTP field of the KEY block), the NUL field contains an 
ASCII character; for any other key data type, the NUL 
field is unused (nonstring keys use 0 as the null value 
when the XBSNUL mask is set). 


XSNUL number 


1 byte 

SFETCH dst,NUL,reg ;NUL field to l-byte dst 
SSTORE src,NUL,reg sl-byte src to NUL field 
SCOMPARE src,NUL,reg ;l-byte src with NUL field 
CREATE Null key.character 

DISPLAY Null key character 

OPEN Null key character 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.20 NXT Field in KEY Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg ;NXT field to l-word dst 
SSTORE src,NXT,reg ;l-word sre to NXT field 
SCOMPARE src,NXT,reg ;l-word sre with NXT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.21 POS Field in KEY Block 


USE Contains the positions of segments for the record keys in 
the index described by the KEY block. (The first key 
position is position 0.) 


INIT XSPOS <number[,number]...> 

SIZE 8 words 

ACCESS SFETCH dst,P0OS,reg 7;POS field to 8-word dst 
SSTORE src,P0OS,reg ;8-word src to POS field 
SFETCH dst,POSn,reg ;POS word n to l-word dst 
SSTORE src,POSn,reg ;l-word src to POS word n 
SCOMPARE src,POSn,reg ;l-word src with POS word n 

INPUT CREATE Key segment positions 

OUTPUT DISPLAY Key segment positions 
OPEN Key segment positions 


CONTROL BLOCK FIELDS 
KEY. BLOCK SUMMARY 


6.4.22 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


REF Field in KEY Block 


Contains the reference 


the KEY block. 


XSREF number 


1 byte 


SFETCH dst,REF,reg 
SSTORE src,REF,reg 
SCOMPARE src,REF,reg 


CLOSE 
CREATE 
DISPLAY 
EXTEND 
OPEN 


Index 
Index 
Index 
Index 
Index 


number for the index 


described by 


;REF field to l-byte dst 
jl-byte src to REF field 


reference 
reference 
reference 
reference 
reference 


number 
number 
number 
number 
number 


;l-byte sre with REF field 


6.4.23 


USE 


INIT 
SIZE 
ACCESS 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


RVB Field in KEY Block 


Contains the virtual block number of the first block of 
the root bucket of the index described by the KEY block. 


None 

2 words 

SFETCH dst,RVB,reg ;RVB field to 2-word dst 
DISPLAY Root index bucket virtual block number 
OPEN Root index bucket virtual block number 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


6.4.24 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


SIZ Field in KEY Block 


Contains the sizes of segments for the record keys in 
index described by the KEY block. 


XSSIZ <number[,number]...> 


8 bytes 

SFETCH dst,SIZ,reg ;S1Z field to 8-byte dst 
SSTORE src,SIZ,reg 78-byte sre to SIZ field 
SFETCH dst,SIZn,reg 7SIZ byte n to l-byte dst 
SSTORE src,SIZn,reg jl-byte sre to SIZ byte n 
SCOMPARE src,SIZn,reg j;l-byte src with SIZ byte n 
CREATE Key segment sizes (bytes) 

DISPLAY Key segment sizes (bytes) 

OPEN Key segment sizes (bytes) 


the 


6.4.25 


USE 


INIT 
SIZE 


ACCESS 


OUTPUT 


CONTROL BLOCK FIELDS 
KEY BLOCK SUMMARY 


TKS Field in KEY Block 


Contains the total key size (sum of the segment sizes) of 
a record key for the index described by the KEY block. 


None 

1 byte 

SFETCH dst,TKS,reg ;TKS field to l-byte dst 

SCOMPARE src,TKS,reg ;l-byte sre with TKS field 

DISPLAY Total key size (sum of key segment’ sizes) 
(bytes) 

OPEN 


Total key size (sum of key segment’ sizes) 
(bytes) 


CONTROL BLOCK FIELDS 
NAM BLOCK SUMMARY 


6.5 NAM BLOCK SUMMARY 


This section summarizes the NAM block and its fields. Table 6-5 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 
code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-5: NAM Block Summary 


Offset Field 
Offset Symbol Size Description 


000 OSRLF 
002 OSRSA 
004 OSRSS 
005 OSRSL 
006 OSDVI 
012 OSWDI 
014 OSFID 
022 OSDID 
030 OSFNB 


word Reserved 

word Resultant string buffer address 
byte Resultant string buffer size (bytes) 
byte Resultant string length (bytes) 
words Device identifier 

word Wildcard directory context 

words File identifier 

words. Directory identifier 

word File specification mask 


PWWRPNPR EE 


000001 NBSVER File version in file 
string or default string 
000002 NBSTYP File type in file string 
or default string 
000004 NBSNAM File name in file string 
or default string 
000010 NBSWVE Wildcard file version in 
file string or default 
string 
000020 NBSWTY Wildcard file type in 
file string or default 
string 
000040 NBSWNA Wildcard file name in 
file string or default 
string 
000100 NBSDIR Directory in file string 
or default string 
000200 NBSDEV Device in file string or 
default string 
000400 NBSNOD Node in file string or 
default string 
001000 NBSWDI Wildcard directory in 
file string or default 
string 
002000 NBSQUO Quoted string in file 
string or default string 
004000 NBSWCH Wildcard context 
established 
“a i 
~ lL word Expanded string buffer address 
034. OSESS 1 byte Expanded string buffer size (bytes) 
035 OSESL*, 1 byte Expanded string length (bytes) 
036 Oswcc 1 word Wildcard context 


The first word of the NAM block is currently reserved, as noted above, 
and must contain the value 0. If the NAM block is extended in the 
future, the first byte will contain an identifier and the second byte 
will contain the (new) block length. 


6.5.1 DID Field in NAM Block 


USE 
INIT 

SIZE 

ACCESS 


INPUT 


OUTPUT 


Contains the directory identifier for the target file. 


None 


3 words 


SFETCH dst,DID,reg 


CREATE 
ENTER 
ERASE 
OPEN 
REMOVE 
RENAME 
SEARCH 


CREATE 
ENTER 
ERASE 
OPEN 
PARSE 
REMOVE 
RENAME 
SEARCH 


Directory 
Directory 
Directory 
Directory 
Directory 
Directory 
Directory 


Directory 
Directory 
Directory 
Directory 
Directory 
Directory 
Directory 
Directory 


;DID field to 3-word dst 


identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 


identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
identifier 


CONTROL BLOCK FIELDS 
NAM BLOCK SUMMARY 


(cleared) 


CONTROL BLOCK FIELDS 
NAM BLOCK SUMMARY 


6.5.2 DVI Field in NAM Block 


USE Contains the device identifier for the target file. 
INIT None 
SIZE 2 words 
ACCESS SFETCH dst,DVI,reg ;DVI field to 2-word dst 
INPUT CREATE Device identifier 

ENTER Device identifier 

ERASE Device identifier 

OPEN Device identifier 

REMOVE Device identifier 

RENAME Device identifier 

SEARCH Device identifier 
OUTPUT " CREATE Device identifier 

ENTER Device identifier 

ERASE Device identifier 

OPEN Device identifier 

PARSE Device identifier 

REMOVE Device identifier 

RENAME Device identifier 


CONTROL BLOCK FIELDS 
NAM BLOCK SUMMARY 


6.5.3 ESA Field in NAM Block 


USE Contains the address of the expanded string buffer. 
INIT NSESA address 
SIZE 1 word 
ACCESS SFETCH dst,ESA,reg ;ESA field to l-word dst 
SSTORE src,ESA,reg jl-word sre to ESA field 
SCOMPARE src,ESA,reg :l-word sre with ESA field 
INPUT CREATE Expanded string buffer address 
ENTER Expanded string buffer address 
ERASE Expanded string buffer address 
OPEN . Expanded string buffer address 
PARSE Expanded string buffer address 
REMOVE Expanded string buffer address 
RENAME Expanded string buffer address 
SEARCH Expanded string buffer address 
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6.5.4 ESL Field in NAM Block 


USE Contains the length of the expanded string. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,ESL,reg ;ESL field to l-byte dst 
SCOMPARE src,ESL,reg ;l-byte sre with ESL. field 

INPUT SEARCH Expanded string length (bytes) 

OUTPUT CREATE Expanded string length (bytes) 
ENTER Expanded string length (bytes) 
ERASE Expanded string length (bytes) 
OPEN Expanded string length (bytes) 
PARSE Expanded string length (bytes) 
REMOVE Expanded string length (bytes) 
RENAME Expanded string length (bytes) 
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6.5.5 ESS Field in NAM Block 


USE Contains the size of the expanded string buffer. 

INIT NSESS number 

SIZE 1 byte 

ACCESS SFETCH dst,ESS,reg ;ESS field to 1l-byte dst 
SSTORE src,ESS,reg sl-byte src to ESS field 
SCOMPARE src,ESS,reg :l-byte sre with ESS field 

INPUT CREATE Expanded string buffer size (bytes) 
ENTER Expanded string buffer size (bytes) 
ERASE Expanded string buffer size (bytes) 
OPEN Expanded string buffer size (bytes) 
PARSE Expanded string buffer size (bytes) 
REMOVE Expanded string buffer size (bytes) 
RENAME Expanded string buffer size (bytes) 
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6.5.6 FID Field in NAM Block 


USE 
INIT 
SIZE 
ACCESS 


INPUT 


OUTPUT 


Contains the file identifier for the target file. 


None 


3 words 


SFETCH dst,FID,reg 


ENTER 
ERASE 
OPEN 
REMOVE 


CREATE 
ERASE 
OPEN 
REMOVE 
RENAME 
SEARCH 


File 
File 
File 
File 


File 
File 
File 
File 
File 
File 


identifier 
identifier 
identifier 
identifier 


identifier 
identifier 
identifier 
identifier 
identifier 
identifier 
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;FID field to 3-word dst 


(only if FBSFID mask is set) 
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6.5.7 ENB Field in NAM Block 


USE Indicates which parts of the merged string were taken from 
the file string or the default string. (The masks in this 
section do not include the NBSWCH mask, which has its own 
description in the next section.) 


INIT None 

SIZE 1 word 

ACCESS STESTBITS mask,FNB,reg ;Test mask bits in FNB field 
SFETCH dst,FNB,reg 7;FNB field to l-word dst 


SCOMPARE src,FNB,reg sl-word src with FNB field 


MASKS NBSDEV Device in file string or default string 
NBSDIR Directory in file string or default string 
NBSNAM File name in file string or default string 
NBSNOD Node in file string or default string 
NBSQUO Quoted string in file string or default string 
NBSTYP File type in file string or default string 
NBSVER File version in file string or default string 
NBSWDI Wildcard directory in file string or default 


string 
NBSWNA Wildcard file name in file string or default 
string 
NBSWTY Wildcard file type in file string or default 
string 
NBSWVE Wildcard file version in file string or default 
string 
OUTPUT CREATE File specification mask 
ENTER File specification mask 
ERASE File specification mask 
OPEN File specification mask 
PARSE File specification mask 
REMOVE File specification mask 
RENAME File specification mask 
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6.5.8 FNB Field in NAM Block (NBSWCH Mask) 


USE Indicates that a valid wildcard context exists. (Masks 
for the FNB field other than the NBSWCH mask are described 
in the previous section.) 


INIT None 
SIZE 1 word 
ACCESS STESTBITS mask,FNB,reg ;Test mask bits in FNB field 
SFETCH dst,FNB,reg ;FNB field to l-word dst 
SCOMPARE src,FNB,reg ;l-word sre with FNB field 
INPUT ERASE Wildcard context established 
OPEN Wildcard context established 
REMOVE Wildcard context established 
RENAME Wildcard context established 
SEARCH Wildcard context established 
OUTPUT CREATE Wildcard context established 
ENTER Wildcard context established 
OPEN Wildcard context established 
PARSE Wildcard context established 
SEARCH Wildcard context established 
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6.5.9 


USE 
INIT 
SIZE 


ACCESS 


INPUT 
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RSA Field in NAM Block 


Contains the address of the resultant string buffer. 


NSRSA address 


1 word 
SFETCH dst,RSA,reg ;RSA field to l-word dst 
SSTORE src,RSA,reg :l-word sre to RSA field 


SCOMPARE src,RSA,reg jl-word sre with RSA field 


SEARCH Resultant string buffer address 
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6.5.10 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


RSL Field in NAM Block 


Contains the length of the resultant string. 


None 

1 byte 

SFETCH dst,RSL,reg ;RSL field to l-byte dst 
SCOMPARE src,RSL,reg yl-byte src with RSL field 
SEARCH Resultant string length (bytes) 
SEARCH Resultant string length (bytes) 
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6.5.11 


USE 
INIT 
SIZE 


ACCESS 


INPUT 
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RSS Field in NAM Block 


Contains the size of the resultant string buffer. 


NSRSS number 


1 byte 
SFETCH dst,RSS,reg ;RSS field to l-byte dst 
SSTORE src,RSS,reg ;l-byte src to RSS field 


SCOMPARE src,RSS,reg ;l-byte src with RSS field 


SEARCH Resultant string buffer size (bytes) 
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6.5.12 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


wcc Field in NAM Block 


Contains wildcard context information. 


None 

1 word 

SFETCH dst,WCC,reg 3;wCC field to l-word dst 
SCOMPARE src,WCC,reg sl-word sre with WCC field 
SEARCH Wildcard context 

PARSE Wildcard context 

SEARCH Wildcard context 
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6.5.13 WDI Field in NAM Block 


USE Contains wildcard directory context information. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,WDI,reg ;WDI field to l-word dst 
SCOMPARE src,WDI,reg :l-word sre with WDI field 
INPUT SEARCH Wildcard directory context 
OUTPUT PARSE Wildcard directory context 
SEARCH Wildcard directory context 
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6.6 PRO BLOCK SUMMARY 

This section summarizes the PRO block and its fields. Table 6-6 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 


code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-6: PRO Block Summary 


Offset Field 
Offset Symbol Size Description 

000 OSCOoD 1 byte PRO block identifier 
000003 XBSPRO PRO block identifier code 

001 OSBLN 1 byte PRO block length (bytes) 
000012 XBSPRL PRO block length (bytes) 

002 OSNXT Ll word Next XAB address 

004 OSPRG 1 word Programmer or member portion of file 
owner. code 

006 OSPRJ 1 word Project or group portion of file owner 


code 
010 OSPRO 1 word File protection code 
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6.6.1 BLN Field in PRO Block (XBS$PRL Code) 


USE 
INIT 
SIZE 


ACCESS 


Contains the length of the PRO block. 
None 
1 byte 


SFETCH dst,BLN,reg :BLN field to 1-byte dst 
SCOMPARE src,BLN,reg :l-byte sre with BLN field 
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6.6.2 COD Field in PRO Block (XBS$PRO Code) 


USE Contains the identifier for the PRO block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,COD,reg ;COD field to l-byte dst 


SCOMPARE src,COD,reg ;l-byte sre with COD field 
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6.6.3 NXT Field in PRO Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg sNXT field to l-word dst 
SSTORE src,NXT,reg -;l-word src to NXT field 
SCOMPARE src,NXT,reg sl-word src with NXxT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 


telat 
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6.6.4 


USE 


INIT 


SIZE 


ACCESS 


INPOT 


OUTPUT 


PRG Field in PRO Block 


Contains the member or 
owner code. 


XSPRG number 
1 word 
SFETCH dst,PRG,reg 


SSTORE src,PRG,reg 
SCOMPARE src,PRG,reg 


CLOSE Programmer 
code 

DISPLAY Programmer 
code 

OPEN Programmer 
code 


programmer portion of the 


;PRG field to l-word dst 
;l-word src to PRG field 
;l-word sre with PRG field 


or member portion of file 


or member portion of file 


or member portion of file 
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file 


owner 


owner 


owner 
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6.6.5 PRJ Field in PRO Block 


USE Contains the group or project portion of the file owner 
code. 

INIT XSPRJI number 

SIZE 1 word 

ACCESS SFETCH dst,PRJ,reg ;PRJ field to l-word dst 
SSTORE src,PRJ,reg ;l-word sre to PRJ field 
SCOMPARE src,PRJ,reg sl-word src with PRJ field 

INPUT CLOSE Project or group portion of file owner code 

OUTPUT DISPLAY Project or group portion of file owner code 
OPEN Project or group portion of file owner code 
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6.6.6 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


OUTPUT 


PRO Field in PRO Block 


Contains the protection code for the file. 


XSPRO number 


1 word 


SFETCH dst,PRO,reg 3; PRO 


SSTORE src,PRO,reg 
SCOMPARE src,PRO, 


CLOSE File 
CREATE File 
DISPLAY File 
OPEN File 


field to l-word dst 


;l-word src to PRO field 


reg ;l-word src with PRO field 


protection 
protection 


protection 
protection 
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code 
code 


code 
code 


CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7 RAB SUMMARY 


This section summarizes the RAB and its fields. Table 6-7 summarizes 
the entire block, giving the offset, offset symbol, size, and a brief 
description for each field; for a field that has mask or code 
symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-7: RAB Summary 


Ne 


Offset Field 
Offset Symbol Size Description 


a rr 


000 OSBID 1 byte RAB identifier code 
000001 RBSBID RAB identifier 
ool OSBLN 1 byte RAB length (bytes) 


000120 RBSBLN Synchronous RAB length 


(bytes) 
000240 RBSBLL Asynchronous RAB length 
(bytes) 
002 OSCTX word User context 
004 OSISI word Internal stream identifier 


006 OSssTS 
010 OSSTV 
012 OSRFA 
020 OSRAC 


word Completion status code 
word Completion status value 
words Record file address 
byte Record access code 


HPWREPE 


000000 RBSSEQ Sequential access 
000001 RBSKEY Key access 
000002 RBSRFA RFA access 


021 OSKSZ 1 byte Key size (bytes) 
022 OSROP 1 word Record processing option mask 


000001 RBSEOF Position to end-of-file 

000002 RBSMAS Mass insert 

000020 RBSLOA Honor bucket fill numbers 

000100 RBSLOC Locate mode 

000200 RBSASY Asynchronous operation 

002000 RBSKGE Greater-than-or-equal key 
criterion 

004000 RBSKGT Greater-than key 
criterion 

010000 RBSFDL Fast deletion 

020000 RBSUIF Update if record exists 


024 OSUSZ 
026 OSUBF 
030 OSRSZ 
032 OSRBF 
034 OSKBF 
036 OSKRF 
037 OSMBF 
040 OSMBC 
041 OSRT1A 
042 OSRHB 
044 OSFAB 
046 OSBRT 


word User buffer size (bytes) 

word User buffer address 

word Record size (bytes) 

word Record buffer address 

word Key buffer address 

byte Key of reference 

Multibuffer count 

byte Multiblock count 

byte Reserved 

word VFC control buffer address 

word FAB address 

words Virtual block number. (VBN) or relative 
record number (RRN) 


i gr — 


NPR PREP EP RP REE eP 
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Me 
ct 
@ 
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6.7.1 BID Field in RAB (RBSBID Code) 


USE Contains the identifier for the RAB, 

INIT None 

SIZE _ 1 byte 

ACCESS SFETCH dst,BID,reg ;BID field to l-byte dst 


SCOMPARE src,BID,reg ;l-byte src with BID field 
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6.7.2 BKT Field in RAB 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


Contains a virtual block number or relative record number 
for a target record. 


RSBKT number 


2 words 

SFETCH dst,BKT,reg ;BKT field to 2-word dst 
SSTORE src,BKT,reg ;2-word sre to BRT field 
SFETCH dst,BKTn,reg +BKT word n to l-word dst 
SSTORE src,BKTn,reg jl-word sre to BKT word n 
SCOMPARE src,BKTn,reg ;l-word src with BKT word n 
READ Virtual block number (VBN) 

SPACE Virtual block number (VBN) increment 
WRITE Virtual block number (VBN) 

FIND Relative record number (RRN) 

GET Relative record number (RRN) 


PUT Relative record number (RRN) 
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6.7.3 BLN Field in RAB 


USE Contains the length of the RAB. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg ;BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 


CODES RBSBLL Asynchronous RAB length (bytes) 
RBSBLN Synchronous RAB length (bytes) 


6-118 


CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7.4 CTX Field in RAB 


USE 


INIT 


SIZE 


ACCESS 


Contains any information you may want to associate with 
the stream at run time. 


RSCTX number 


1 word 
‘SFETCH dst,CTX,reg ;CTX field to l-word dst 
SSTORE src,CTX,reg ;l-word sre to CTX field 


SCOMPARE src,CTX,reg sl-word sre with CTX field 
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6.7.5 FAB Field in RAB 


USE Contains the address of the FAB for the target file. 

INIT RSFAB address 

SIZE 1 word 

ACCESS SFETCH dst,FAB,reg ;FAB field to l-word dst 
SSTORE src,FAB,reg ;l-word sre to FAB field 


SCOMPARE src,FAB,reg ;l-word sre with FAB field 


INPUT CONNECT FAB address 


6-120 


CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7.6 ISI Field in RAB 


USE Contains the internal stream identifier for the target 
file. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,ISI,reg ;ISI field to l-word dst 
SCOMPARE src,ISI,reg :l-word sre with ISI field 
INPUT DELETE Internal stream identifier 
DISCONNECT Internal stream identifier 
FIND Internal stream identifier 
FLUSH Internal stream identifier 
FREE Internal stream identifier 
GET Internal stream identifier 
NXTVOL Internal stream identifier 
PUT Internal stream identifier 
READ Internal stream identifier 
REWIND Internal stream identifier 
SPACE Internal stream identifier 
TRUNCATE Internal stream identifier 
UPDATE Internal stream identifier 
WAIT Internal stream identifier 
WRITE Internal stream identifier 
OUTPUT CONNECT Internal stream identifier 


DISCONNECT Internal stream identifier 
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6.7.7 KBF Field in RAB 


USE Contains the address of the key buffer for the target 
record. 
INIT RSKBF address 
SIZE 1 word 
ACCESS SFETCH dst,KBF,reg ;KBF field to l-word dst 
SSTORE src,KBF,reg ;l-word sre to KBF field 
SCOMPARE src,KBF,reg ;l-word src with KBF field 
INPUT FIND Key buffer address 
GET Key buffer address 
PUT Key buffer address 
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6.7.8 


USE 


INIT 
SIZE 


ACCESS 


INPUT 
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KRF Field in RAB 


Contains the index reference number of the index for the 
operation. 


RSKRF number 


1 byte 

SFETCH dst,KRF,reg ;KRE field to l-byte dst 
SSTORE src,KRF,reg ;l-byte sre to KRF field 
SCOMPARE src,KRF,reg ;l-byte src with KRF field 
CONNECT Key of reference 

FIND Key of reference 

GET Key of reference 

REWIND Key of reference 
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6.7.9 KSZ Field in RAB 


USE Contains the size of the record key for the operation. 
INIT RSKSZ number 
SIZE 1 byte 
ACCESS » SFETCH dst,KSZ,reg 7KSZ field to l-byte dst 
SSTORE src,KSZ,reg 3l-byte src to KSZ field ; 
SCOMPARE src,KSZ,reg ;l-byte sre with KSZ field 
INPUT FIND Key size (bytes) 
GET Key size (bytes) 
PUT Key size (bytes) 
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6.7.10 MBC Field in RAB 


USE Contains the multiblock count for the stream. 

INIT RSMBC number 

SIZE 1 byte 

ACCESS SFETCH dst,MBC,reg ;MBC field to l-byte dst 
SSTORE src,MBC,reg ;l-byte src to MBC field 


SCOMPARE src,MBC,reg ;l-byte src with MBC field 


INPUT CONNECT Multiblock count 
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6.7.11 MBF 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


Field in RAB 


Contains the multibuffer count for the stream. 


RSMBF number 


1 byte 
SFETCH dst ,MBF,reg ;MBF field to l-byte dst 
SSTORE src,MBF,reg ;l-byte src to MBF field 


SCOMPARE src,MBF,reg ;l-byte src with MBF field 


CONNECT Multibuffer count 
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USE 


INIT 


SIZE 


ACCESS 


CODES 


INPOT 


RAC Field in RAB 
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Contains the access mode code for the operation. 


RSRAC code 
1 byte 


SFETCH dst,RAC,reg 
SSTORE src,RAC,reg 


SCOMPARE src,RAC,reg 


RBSKEY Key access 
RBSRFA RFA access 
RBSSEQ Sequential 


FIND Record 
GET Record 
PUT Record 


;RAC field to l-byte dst 


;1- 
z1- 


access 


access 
access 
access 
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byte src. to RAC field 
byte sre with RAC field 


code 
code 
code 
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6.7.13 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


RBF Field in RAB 


Contains 
operation. 


the address of 


RSRBF address 


1 word 


SFETCH dst,RBF,reg 
SSTORE src,RBF,reg 


SCOMPARE src,RBF,reg 


PUT 
UPDATE 
WRITE 


CONNECT 
GET 

PUT 
READ 


Record 
Record 
Record 


Record 
Record 
Record 
Record 


the 


record buffer 


;RBF field to l-word dst 
jl-word sre to RBF field 


buffer 
buffer 
buffer 


buffer 
buffer 
buffer 
buffer 
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address 
address 
address 


address 
address 
address 
address 


;l-word sre with RBF field 


for 


the 
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6.7.14 RFA Field in RAB 


USE Contains the record file address for the target record. 
INIT None 
SIZE 3 words 
ACCESS SFETCH dst,RFA,reg ;RFA field to 3-word dst 
INPUT FIND Record file address 
GET Record file address 
OUTPUT CONNECT End-of-file address 
FIND Record file address 
GET Record file address 
PUT Record file address 
READ Virtual block number (2 words) 
WRITE Virtual block number (2 words) 
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6.7.15 


USE 


INIT 
SIZE 


ACCESS 


INPUT 


RHB Field in RAB 


Contains the address of the VFC fixed control area 


for the target record. 


RSRHB address 


1 word 

SFETCH dst,RHB,reg :RHB field to l-word dst 
SSTORE src,RHB,reg sl-word src to RHB field 
SCOMPARE src,RHB,reg sl-word src with RHB field 
GET VFC control buffer address 

PUT VFC control buffer address 

UPDATE VFC control buffer address 
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buffer 


6.7.16 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


ROP Field in RAB (RBSASY Mask) 


Requests asynchronous operation. ' 


RSROP mask 

1 word 

SSET mask,ROP,reg 7M 
SOFF mask,ROP,reg 3M 
STESTBITS mask,ROP,reg ;T 
SFETCH dst,ROP,reg ;R 


SSTORE src,ROP,reg 
SCOMPARE src,ROP,reg 


CONNECT 
DELETE 
DISCONNECT 
FIND 
FLUSH 
FREE 

GET 
NXTVOL 
PUT 

READ 
REWIND 
SPACE 
TRUNCATE 
UPDATE 
WRITE 


Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
Asynchronous 
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ask bits 
ask bits 
est mask 
OP field 


operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 
operation 


CONTROL BLOCK FIELDS 


on in ROP fie 


RAB SUMMARY 


ld 


off in ROP field 


bits in ROP f 
to l-word dst 


;l-word src to ROP field 
sl-word sre with ROP field 


ield 
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6.7.17 ROP Field in RAB (RBSEOF Mask) 


USE Requests initial stream context at end-of-file. 

INIT RSROP mask 

SIZE 1 word 

ACCESS SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word sre to ROP field 


SCOMPARE src,ROP,reg zl-word sre with ROP field 


INPUT CONNECT Position to end-of-file 
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USE 
INIT 
SIZE 


ACCESS 


INPUT 


ROP Field in RAB (RBSFDL Mask) 


Requests fast deletion. 
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RSROP mask 

1 word 

SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word sre to ROP field 


SCOMPARE src,ROP,reg ;l-word sre with ROP field 


DELETE Fast deletion 
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6.7.19 ROP Field in RAB (RBSKGE Mask) 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


Requests greater-than-or-equal key match criterion. 


RSROP mask 

1 word 

SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg sl-word src to ROP field 
SCOMPARE src,ROP,reg sl-word sre with ROP field 
FIND Greater-than-or-equal key criterion 

GET Greater-than-or-equal key criterion 
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USE 
INIT 


SIZE 


ACCESS 


INPUT 


ROP Field in RAB (RBSKGT Mask) 


CONTROL BLOCK FIELDS 
RAB SUMMARY 


Requests greater-then key match criterion. 


RSROP mask 

1 word 

SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word src to ROP field 
SCOMPARE src,ROP,reg ;l-word src with ROP field 
FIND Greater-than key criterion 

GET Greater-than key criterion 
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6.7.21 ROP 
USE 

INIT 


SIZE 


ACCESS 


INPOT 


Field in RAB (RBSLOA Mask) 


Requests bucket fill number honoring. 


RSROP mask 

1 word 

SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg Mask bits off in ROP field 
STESTBITS mask,ROP;reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg jl-word sre to ROP field 
SCOMPARE src,ROP,reg sl-word sre with ROP field 
PUT Honor bucket fill numbers 

UPDATE Honor bucket fill numbers 
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INIT 
SIZE 


ACCESS 


INPUT 


ROP Field in RAB (RBSLOC Mask) 


Requests locate mode operation. 
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RSROP mask 
1 word 
SSET mask,ROP,reg :Mask bits on in ROP field 
SOFF mask,ROP,reg sMask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SPETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg sl-word sre to ROP field 
SCOMPARE src,ROP,reg sl-word src with ROP field 
CONNECT Locate mode 
GET Locate mode 
PUT Locate mode 

oO 
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6.7.23 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


ROP Field in RAB (RBSMAS Mask) 


Requests mass insertion. 


RSROP mask 

1 word 

SSET mask,ROP,reg :Mask bits on in ROP field 
SOFF mask,ROP,reg 3Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
SSTORE src,ROP,reg ;l-word src to ROP field 


SCOMPARE src,ROP,reg ;l-word sre with ROP field 


PUT Mass insert 
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6.7.24 


USE 
INIT 
SIZE 


ACCESS 


INPUT 


ROP Field in RAB (RBSUIF Mask) 


CONTROL BLOCK FIELDS 
RAB SUMMARY 


Requests update if target record already exists. 


RSROP mask 

1 word 

SSET mask,ROP,reg ;Mask bits on in ROP field 
SOFF mask,ROP,reg ;Mask bits off in ROP field 
STESTBITS mask,ROP,reg ;Test mask bits in ROP field 
SFETCH dst,ROP,reg ;ROP field to l-word dst 
S$STORE src,ROP,reg ;l-word sre to ROP field 


SCOMPARE src,ROP,reg ;l-word sre with ROP field 


PUT Update if record exists 
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CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7.25 


USE 


INIT 


SIZE 


ACCESS 


INPUT 


OUTPUT 


RSZ Field in RAB 


Contains the size of the target record. 


RSRSZ number 


1 word 


SFETCH dst,RSZ,reg 


SSTORE src,R 


SZ,reg 


SCOMPARE src,RSZ,reg 


PUT 
UPDATE 
WRITE 


GET 
READ 


Record 
Record 
Record 


Record 
Record 


size 
size 
size 


size 
size 


sRSZ field to l-word dst 
:l-word src to RSZ field 
sl-word sre with RSZ field 


(bytes) 
(bytes) 
(bytes) 


(bytes) 
(bytes) 
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CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7.26 STS Field in RAB 
USE Contains the completion status code for the operation. 
INIT None 
SIZE 1 word 
ACCESS SFETCH dst,STS,reg ;STS field to l-word dst 
SCOMPARE src,STS,reg sl-word sre with STS field 
OUTPUT CONNECT Completion status code 
DELETE Completion status code 
DISCONNECT Completion status code 
FIND Completion status code 
FLUSH Completion status code 
FREE Completion status code 
GET Completion status code 
NXTVOL Completion status code 
PUT Completion status code 
READ Completion status code 
REWIND Completion status code 
SPACE Completion status code 
TRUNCATE Completion status code 
UPDATE Completion status code 
WRITE Completion status code 
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CONTROL BLOCK FIELDS 


RAB SUMMARY 


6.7.27 


USE 


INIT 


SIZE 


ACCESS 


OUTPUT 


STV Field in RAB 


Contains the completion status value for the operation. 


None 


1 word 


SFETCH dst,STV,reg 
SCOMPARE src,STV,reg 


CONNECT 
DELETE 
DISCONNECT 
FIND 
FLUSH 
FREE 

GET 
NXTVOL 
PUT 

READ 
REWIND 
SPACE 
TRUNCATE 
UPDATE 
WRITE 


Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 
Completion 


7;STV field to l-word dst 
;l-word sre with STV field 


status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
status 
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value 
value 
value 
value 
value 
value 
value 
value 
value 
value 
value 
value 
value 
value 
value 


CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7.28 UBF Field in RAB 


USE Contains the address of the user buffer for the operation. 
INIT RSUBF address 
SIZE 1 word 
ACCESS SFETCH dst,UBF,reg ;UBF field to l-word dst 
SSTORE src,UBF,reg :l-word src to UBF field 
SCOMPARE src,UBF,reg s;l-word src with UBF field 
INPUT CONNECT User buffer address 
GET User buffer address 
PUT User buffer address 
READ User buffer address: 
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CONTROL BLOCK FIELDS 
RAB SUMMARY 


6.7.29 USZ Field in RAB 


USE Contains the size of the user buffer for the operation. 
INIT RSUSZ number 
SIZE 1 word 
ACCESS SFETCH dst,USZ,reg 7USZ field to l-word dst 
SSTORE src,USZ,reg ;l-word sre to USZ field 
SCOMPARE src,USZ,reg ;l-word sre with USZ field 
INPUT CONNECT User buffer size (bytes) 
GET User buffer size (bytes) 
PUT User buffer size (bytes) 
READ User buffer size (bytes) 
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CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8° SUM BLOCK SUMMARY 


This section summarizes the SUM block and its fields. Table 6-8 
summarizes the entire block, giving the offset, offset symbol, size, 
and a brief description for each field; for a field that has mask or 
code symbols, the table also gives the value, symbol, and a brief 
description for each mask or code. 


Table 6-8: SUM Block Summary 


i 


Offset Field 
Offset Symbol Size Description 


i 


000 OSCOD 1 byte SUM block identifier 
000005 XBSSUM SUM block identifier code 
001 OSBLN 1 byte SUM block length (bytes) 


000012 XBSSML SUM block length (bytes) 


002 OSNXT 1 word Next XAB address 

004 OSNOK 1 byte Number of indexes 

005 OSNOA 1 byte Number of areas 

006 OSNOR 1 byte Reserved 

007 1 byte Reserved 

010 OSPVN 1 word Prologue version number 


eC ne eR 
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CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.1 BLN Field in SUM Block (XBSSML Code) 


USE Contains the length of the SUM block. 

INIT None 

SIZE 1 byte 

ACCESS SFETCH dst,BLN,reg 7BLN field to l-byte dst 


SCOMPARE src,BLN,reg ;l-byte src with BLN field 
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CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.2 COD Field in SUM Block (XBSSUM Code) 


USE Contains the identifier for the SUM block. 

INIT None 

SIZE 1 byte 

ACCESS $FETCH dst ,COD,reg ;COD field to l-byte dst 


SCOMPARE src,COD,reg ;l-byte src with COD field 


6-147 


CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.3 NOA Field in SUM Block 


USE Contains the number of areas in the file. 
INIT None 
SIZE 1 byte 
ACCESS SFETCH dst,NOA,reg ;NOA field to l-byte dst 
SCOMPARE src,NOA,reg ;l-byte sre with NOA field 
OUTPUT DISPLAY Number of areas 
OPEN Number of areas 
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CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.4 NOK Field in SUM Block 


USE Contains the number of indexes in the file. 
INIT None 
SIZE 1 byte 
ACCESS SFETCH dst,NOK,reg ;NOK field to l-byte dst 
SCOMPARE src,NOK,reg sl-byte sre with NOK field 
OUTPUT DISPLAY Number of indexes 
OPEN Number of indexes 
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CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


6.8.5 NXT Field in SUM Block 


USE Contains the address of the next XAB (ALL, DAT, KEY, PRO, 
or SUM block) in a chain of XABs. 
INIT XSNXT address 
SIZE 1 word 
ACCESS SFETCH dst,NXT,reg ;NXT field to l-word dst 
SSTORE src,NXT,reg ;l-word sre to NxT field 
SCOMPARE src,NXT,reg sl-word sre with NxT field 
INPUT CLOSE Next XAB address 
CREATE Next XAB address 
DISPLAY Next XAB address 
ENTER Next XAB address 
ERASE Next XAB address 
EXTEND Next XAB address 
OPEN Next XAB address 
PARSE Next XAB address 
REMOVE Next XAB address 
RENAME Next XAB address 
SEARCH Next XAB address 
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6.8.6 


USE 
INIT 
SIZE 


ACCESS 


OUTPUT 


CONTROL BLOCK FIELDS 
SUM BLOCK SUMMARY 


PVN Field in SUM Block 


Contains the prologue version number for the file. 


None 

1 word 

SFETCH dst,PVN,reg - ¢PVN field to l-word dst 
SCOMPARE src,PVN,reg :l-word sre with PVN field 
DISPLAY Prologue version number 

OPEN Prologue version number 
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CHAPTER 7 


EXAMPLE PROGRAMS 


This chapter contains example programs; the titles of the 


are: 
@ PARSE - SPARSE TEST 
@ SEARCH -— SSEARCH TEST 
e@ ERASE -— SERASE TEST 
@ RENAME —- SRENAME TEST 
e GSA - CORE SPACE ALLOCATOR 
Sections 7.1 through 7.4 contain these programs and give 
for building and running them. 
NOTE 
References to [uic] in the command lines 
in the following sections indicate that 


you should include your default UIC. 


Each program requires the GSA routine (Section 7.5) for 
dynamic memory: 


MAC SY:GSA=LB: [1,1] RMSMAC/ML,SY:3 [uic]GSA 


programs 


instructions 


allocating 


EXAMPLE PROGRAMS 


7.1 PARSE - SPARSE TEST 


The following shows how to build the PARSE program (Example 
shows a brief sample run of the program. 


MAC S¥:PARSE#LB: [1,1] RMSMAC/ML, SY: [ulc] PARSE 

TRB 

TKB>S¥: PARSE/CP=SY: PARSE, S¥:GSA 

TKB>LB: [1,1] VMLIB/LB: INIDM:EXTSK 

TKB>LB: [1,1] RMSLIB/LB 

TKB>// 

RUN DB1: [200,1] PARSE 

Enter the default name string: DBO: 

Enter the primary name string: ,LOG 

SPARSE expanded string is DB0O:[70,5].LOG 
File name bits (FNB) are 004202 
(DEV, TYP) 

Enter the default name string: *%g% 


EXAMPLE PROGRAMS 
Example 7-1: PARSE - SPARSE Test 
-TITLE PARSE -— SPARSE TEST 
-IDENT /X01.00/ 
e-ENABL LC 
-MCALL FABSB,NAMSB,GSAS 


.MCALL SPARSE,SSTORE,$FETCH,SCOMPARE 
-MCALL ALUNSS,QIOWS,DIRS,EXITSS 


This program tests/demonstrates the use of 
the RMS-11 SPARSE function. 


wee Ne Ne 


RMS-11 Data Structures 


me me Ne 


GSAS GSA 


FAB:: FABSB Argument FAB 


; 
FSNAM NAM ; Link to NAM 
FSLCH 2. ; Channel #2 
FABSE 


NAM: > NAMSB 
NSESA EXPSTR 
NSESS 128. 
NAMSE 


NAM definition 
EXP STR address 
EXP STR length 


se Ne Ne 


.PSECT SCODES,RO,I 


PARSE:: 


ALUNSS #1,#"TI,#0 Assign the terminal 


’ 
MOV #FAB,RO ; Map the target FAB 
MOV #EDBLK,R2 ; Map the exit block 
MOV #NAM,R3 ; Map the target NAM 
MOV #READ, R4 ; Map the input DPB 
MOV #WRITE,RS5S ; Map the output DPB 
CLR Q.IOPL+4 (R5) + Turn off carriage ctl 
MOV #QUES1,Q.IOPL(R5) 
MOV #QUESI1L,Q.IOPL+2 (R5) 
DIRS R5 ; Prompt for the DNA 
TSTB IOSTAT ; Check the IOSB 
BMI . EXIT ; Exit if error 
MOV #BUFF1,Q.IOPL(R4) 
MOV #64.,Q.1OPL+2 (R4) 
DIRS R4 * Get the response 
TSTB IOSTAT Check the IOSB 
BMI EXIT Exit if error 


SSTORE IOLEN,DNS,RO 
SSTORE #BUFF1,DNA,RO 


Set the default length 
Set the default address 


me Nee NON 


MOV #QUES2,Q.IOPL(R5) 

MOV #QUES2L,Q.1OPL+2 (R5) 

DIRS R5 ; Prompt for the DNA 
TSTB IOSTAT ; Check the IOSB 

BMI EXIT ; Exit if error 

MOV #BUFF2,Q.IOPL(R4) 

MOV #64.,0.1OPL+2 (R4) 

DIRS R4 ; Get the response 
TSTB IOSTAT ; Check the IOSB 

BMI EXIT > Exit if error 


EXAMPLE PROGRAMS 


EXIT: 


ERROR: 


BITS: 


PRINT: 


SSTORE IOLEN,FNS,RO 
SSTORE #BUFF2,FNA,R0 
MOV #40,Q.IOPL+4 (R5) 
SPARSE RO 

SCOMPARE #0,STS,RO 
BLT ERROR 

CLR (R2) 

SFETCH (R2),ESL,R3 
TST (R2)+ 
$FETCH (R2)+,ESA,R3 
SFETCH (R2),FNB,R3 
MOV #ESSSTR,R1 
CALL PRINT 

CALL BITS 

BR PARSE 
EXITSS 

SFETCH (R2)+,STS,RO 
SFETCH (R2),STV,RO 
MOV #ERRSTR,R1 
CALL PRINT 

BR PARSE 

MOV #EDBLK,R2 
SFETCH RO,FNB,R3 
BIT #2000,R0 
BEQ 28 

MOV #QUO, (R2)+ 
BIT #1000,R0 
BEQ 4s 

MOV #WDI, (R2) + 
BIT #400,R0 

BEQ 6S 

MOV #NOD, (R2)+ 
BIT #100,R0 

BEQ 8s 

MOV #DIR, (R2)+ 
BIT #40,R0 

BEQ 10$ 

MOV #WNA, (R2)+ 
BIT #20,R0 

BEQ 12s 

MOV #WTY, (R2)+ 
BIT #10,R0 

BEQ 148 

MOV #WVE, (R2)+ 
BIT #4,R0 

BEQ 16s 

MOV #NME, (R2) + 
BIT #2,R0 

BEQ 18s 

MOV #TYP,(R2)+ 
BIT #1,R0 
BEQ 208 

MOV #VER, (R2) + 
MOV #END, (R2) 
MOV #DEV,R1 
CALL PRINT 
RETURN 

MOV #EDBLK, R2 


me MO Me Me me SO Ne Ne Ne Ne Ne NO Ne Me Ne 


me 


me Me me NO Ne 


MO Ne NO Ne NO Ne BO we NO Ne TE Ne SO We NO Ne SH Ne NO Ne NO Ne NO Ne TE Ne SE Me NO Ne NO Ne TO Me NO Ne 


Set the default length 
Set the default address 
Restore carriage control 
Parse the strings 

An error? 

Yes if MI; display it 


_ Init the length 


Get the string length 
Advance 

Get the string address 
Get the file name bits 
Select the format string 
Display the file 

Do the FNB bit disply 
And let's try another 


Task exit 


Set the STS returned 

And the STV 

Set the error format string 
Go edit and print the message 


Let's try this again 


Init EDBLK address 
Get the FNB bits 
Quoted string? 

No if EQ 

Set Quoted string 
Wild directory? 

No if EQ 

Set wild directory 
Node spec? 

No if EQ 

Set nodespec 
Directory spec? 

No if EQ 

Set directory 

Wild name? 

No if eq 

Set wild name 

Wild type? 

No if EQ 

Set wild type 

Wild version? 

No if EQ 
Set wild. 
Name? 

No if EQ 
Set name 
Type? 

No if EQ 
Set type 
Version? 
No if EQ 
Set version 

End with a null... 
Set the default (dev) 
Edit and print 

And exit 


version 


Setup edit 


QUES1: 
QUES2: 


ERRSTR: 
ESSSTR: 


DEV: 
NOD: 
DIR: 
NME: 
QUO: 
TYP: 
VER: 
WDI: 
WNA: 
WTY: 
WVE: 
END: 


EDBLK: 
BUFFER: 
BUFF 1: 
BUFF2: 
EXPSTR: 
IOSTAT: 
IOLEN: 
READ: 
WRITE: 


MOV 
CALL 
MOV 
MOV 
DIRS 
RETURN 


- PSECT 


-Ascii 
QUESIL 
Ascii 
QUES 2L 
-Asciz 
-Ascii 
.Asciz 
~Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
-Asciz 
~Asciz 
-Asciz 
-Asciz 
-Asciz 


- EVEN 
-BLKW 


-Blkb 
-Blkb 
»BLKB 
-WORD 
-WORD 
QIOWS 
QIOWS 


- END 


EXAMPLE 


#BUFFER,RO ; Output buffer 
SEDMSG ; Exit the string 
#BUFFER,Q.IOPL(RS5) 
R1,Q.IOPL+2(R5) 
R5 3; Send to the terminal 
; Return to caller 


SDATAS, RW,D 


<15><12>"Enter the default name string: " 
= ., -— QUES1L 

<15><12>"Enter the primary name string: " 
=. - QUES2 

"SPARSE error -- STS=%P, STV=%3P" 

"SPARSE expanded string is %VA$N" 

My File name bits (FNB) are %P" 

" (DEVSI" 

", NODSI" 

, DIRSI" 

, NAMSI" 

, QUOZI" 
“, TYPZI" 

, VERSI" 

, WDIZI" 

, WNASI" 
", WTY3SI" 
", WVESI" 


IO0.RLB,1,1,,10STAT 
IO.WLB,1,1,,10STAT, ,<,,40> 


PARSE 


PROGRAMS 


EXAMPLE PROGRAMS 


7.2 SEARCH - $SEARCH TEST 


The following shows how to build the SEARCH program (Beampie 7-2) 
shows a brief sample run of the program. 


MAC SY:SEARCH=LB: [1,1] RMSMAC/ML, SY: [vic] SEARCH 
TKB 

TKB>SY: SEARCH/CP=SY:SEARCH,SY:GSA 

TKB>LB: [1,1] VMLIB/LB: INIDM: EXTSK 
TKB>LB: [1,1] RMSLIB/LB 

TKB>// 

RUN DB1l:[200,1]SEARCH 


Enter a wildcard filespec: vVHC*.* 
DBO: [70,5] VHC.SEQ;1 

DBO: [70,5] VHC. INX;7 

DBO: [70,5] VHCKRO. DES ;3 

DBO: [70,5] VHC.DES;2 

DBO: [70,5] VHC.MST;1 

DBO: [70,5] VHC. ERR;1 

DBO: [70,5] VHC.KRO;1 

DBO: [70,5] VHC.KR1;1 

DBO: [70,5] VHCKRO. INX; 3 


Total of 9 files matching DBO: [70,5]VHC*.* 
Enter a wildcard filespec: [70,*]CUST.* 
DBO: [70,10]CUST.FILE;1 

DBO: [70,10]CUST.SEQ;1 

DBO: [70,5]CUST.MST;1 

DBO: [70,5]CUST.FIL;1 

Total of 4 files matching DBO: [70,*]CUST.* 


Enter a wildcard filespec: “*Z 


and 


» TITLE 
- IDENT 


. ENABL 
-MCALL 


-MCALL 
-MCALL 


me Ne Se Ne 


we me we 


GSAS 


FAB:: FABSB 
FSDNA 
FSDNS 
FSNAM 
FSLCH 
FABSE 


NAM: : NAMSB 
NSESA 
NSESS 
NSRSA 
NSRSS 
NAMSE 


- PSECT 


SEARCH: : 
‘ALUNSS 
MOV 
MOV 
MOV 
MOV 
MOV 
CLR 
MOV 
MOV 
DIRS 
TSTB 
BMI 
MOV 
MOV 
DIRS 
TSTB 
BMI 
SSTORE 
SSTORE 
MOV 
CLR 
SPARSE 


SCOMPARE #0,STS,RO 


BLT 
GETFIL: 


-FILCNT 


EXAMPLE PROGRAMS 
Example 7-2: SEARCH - SSEARCH Test 
SEARCH - SSEARCH TEST 


/X01.00/ 


LC 


FABSB,NAMSB,GSAS 


$PARSE, SSEARCH, SSTORE, SFETCH, SCOMPARE 
ALUNSS,QIOWS ,DIRS,EXITSS 


This program tests/demonstrates the use of 
the RMS-11 SSEARCH function. 


RMS-11 Data Structures 


GSA 

; Argument FAB 
SYDSKA 3; If no device, SY: 
SYDSKL ; should be used 
NAM 3; Link to NAM 
2. ; Channel #2 

; NAM definition 
EXPSTR ; EXP STR address 
128. 7 EXP STR length 
RESSTR ; RES STR address 
128. 3 RES STR length 


SCODES,RO,I 


#1,#"T1I,#0 ; Assign the terminal 

#FAB,RO 7 Map the target FAB 

#EDBLK,R2 ; Map the exit block 

#NAM,R3 ; Map the target NAM 

#READ,R4 ; Map the input DPB 

#WRITE,R5 ; Map the output DPB 
f 


Q.IOPL+4 (R5) 
#QUES,Q.IOPL(R5) 
#QUESL,Q. IOPL+2 (R5) 

R5 ; Prompt for the DNA 
IOSTAT ; Check the IOSB 
EXIT 3; Exit -if error 
#BUFF,Q.IOPL(R4) 

#64.,Q.10PL+2 (R4) 


Turn off carriage ctl 


R4 Get the response 
IOSTAT Check the IOSB 

EXIT Exit if error 
IOLEN,FNS,RO Set the string length 
#BUFE,FNA,RO Set the string address 


#40,Q.1IOPL+4(R5); Restore carriage control 
Init count of matches 
Parse the strings 

An error? 


Yes if MI; display it 


RO 


Tt tt eT 


ERROR 


EXAMPLE PROGRAMS 


MOV #EDBLK,R2 ; Reset the edit block addr 

SSEARCH RO ; Get a matching file 

SCOMPARE #0,STS,R0 3; Error? 

BLT ERROR + Yes if LT 

CLR (R2) : Init the length 

SFETCH (R2),RSL,R3 + Get the string length 

TST (R2)+ ; Advance 

SFETCH (R2)+,RSA,R3 3; Get the string address 

MOV #RSSSTR,R1L + Select the format string 

TST FILCNT ; First file needs a blank 

BNE NOTEST + line before it 

MOV #RSSST1,R1 ; Insert CR/LF first 
NOTFST: 

CALL PRINT } Display the file 

MOV #FAB,RO : Rest the FAB address 

INC FILCNT s Count this file 

BR GETFIL ; And let's try another 
EXIT: 

EXITSS ; Task exit 
ERROR: 

SCOMPARE #ERSNMF,STS,RO ; No more matches? 

BNE ERRORO , ; No - some other error 

MOV FILCNT, (R2)+ ; Set the cound of matches 

BEQ ERROR2 ; No files... 

CLR (R2) ; Give the ESA 

SFETCH (R2),ESL,R3 3 Set the length 

TST (R2)+ + Advance word 

SFETCH (R2),ESA,R3 ; Set the address 

MOV #TTLSTR,R1 3 Set the format string 

BR ERRORL : Go show it and exit 
ERROR2: 

CLR -(R2) + Setup for string length 

SFETCH (R2),ESL,R3 3 Set the length 

TST (R2)+ : Advance to next word 

SFETCH (R2),ESA,R3 ; Set the address 

MOV #NOFILE,R1 ; Set the format string 

BR ERRORL ; Print the error 
ERRORO: 

SFETCH (R2)+,STS,RO : Set the STS returned 

SFETCH (R2),STV,RO ; And the STV 

MOV #ERRSTR,RI1 ; Set the error format string 
ERRORIL: 

CALL PRINT ; Go edit and print the message 

JMP SEARCH ; Let's try this again 
PRINT: 

MOV #EDBLK,R2 3 Setup edit 

MOV #BUFFER,RO ; Output buffer 

CALL SEDMSG > Exit the string 

MOV #BUFFER,Q.IOPL(R5) 

MOV R1,Q.IOPL+2(R5) 

DIRS R5 ; Send to the terminal 

RETURN ; Return to caller 


»~PSECT SDATAS,RW,D 


SYDSKA: .Ascii "SY:" 
SYDSKL = . - SYDSKA 

QUES: sAscii <15><12>"Enter a wildcard filespec: " 
QUESL = . - QUES 


ERRSTR: .Asciz "SSEARCH error -- STS=%P, STV=%P" 
RSSST1: .Ascii "SN" 
RSSSTR: .Asciz " %VA" 


EXAMPLE PROGRAMS 


NOFILE: .Asciz "%NNo files matching %VA%N" 

TTLSTR: .Asciz "SNTotal of @D files matching %VA3N" 
- EVEN 

FILCNT: .WORD 0 

EDBLK: .BLKW 6 

BUFFER: 

BUFF: -Blkb 128. 

EXPSTR: .BLKB 128. 

RESSTR: .BLKB 128. 

IOSTAT: .WORD 0 

IOLEN: »WORD 0 

READ: QIows IO.RLB,1,1,,1OSTAT 

WRITE: QIOWS IO.WLB,1,1,,I10STAT,,<,,40> 


«END SEARCH 


EXAMPLE PROGRAMS 


7.3 ERASE - SERASE TEST 


The following shows how to build the ERASE program (Example 7-3) 
shows a brief sample run of the program. 


MAC SY:ERASE=LB: [1,1]RMSMAC/ML, SY: [uic] ERASE 
TKB 

TKB> SY: ERASE/CP=SY:ERASE,SY:GSA 

TKB> LB: [1,1] VMLIB/LB: INIDM: EXTSK 

TKB>LB: [1,1] RMSLIB/LB 

TKB> // 

RUN DBl:[200,1] ERASE 

File(s) to erase: DES.XXX 


File DBO:[70,5]DES.XXX;3 deleted 
Total of 1 files matching DBO:[70,5]DES.XXX deleted 


File(s) to erase: “Z 


and 


- TITLE 
» [IDENT 


« ENABL 
-MCALL 


»MCALL 
-MCALL 


we we Ne te 


we Ne Ne 


GSAS 


FAB:: FABSB 
FSDNA 
FSDNS 
FSNAM 
FSLCH 
FABSE 


NAM:: NAMSB 
NSESA 
NSESS 
NSRSA 
NSRSS 
NAMSE 


- PSECT 


ERASE:: 

ALUNSS 
MOV 
MOV 
MOV 
MOV 
MOV 
CLR 
MOV 
MOV 
DIRS 
TSTB 
BMI 
MOV 
MOV 
DIRS 
TSTB 
BMI 
SSTORE 
SSTORE 
MOV 
CLR 
SPARSE 


SCOMPARE #0,STS,RO 


BLT 
GETFIL: 


EXAMPLE PROGRAMS 
Example 7-3: ERASE - SERASE Test 
ERASE - SERASE TEST 
/X01.00/ 
LC 
FABSB, NAMSB, GSAS 


SPARSE, SERASE, SSTORE, SFETCH, SCOMPARE 
ALUNSS, QIOWS ,DIRS, EXITSS 


This program tests/demonstrates the use of 
the RMS-11 SERASE function, with implicit SSEARCH. 


RMS-11 Data Structures 


GSA 

; Argument FAB 
SYDSKA > If no device, SY: 
SYDSKL ; should be used 
NAM ; Link to NAM 
ae ; Channel #2 

; NAM definition 
EXPSTR ; EXP STR address 
128. ; EXP STR length 
RESSTR ; RES STR address 
128. ; RES STR length 


SCODES,RO,I 


#1,#"TI,#0 ; Assign the terminal 

#FAB,RO ; Map the target FAB 

#EDBLK,R2 + Map the exit block 

#NAM, R3 ; Map the target NAM 

#READ, R4 ; Map the input DPB 

#WRITE,R5 ; Map the output DPB 
, 


Q.IOPL+4 (R5) 
#QUES,Q.IOPL(R5) 
#QUESL,Q.IOPL+2(R5) 

R5 ; Prompt for the DNA 
IOSTAT ; Check the IOSB 
EXIT * Exit if error 
#BUFF,Q.IOPL(R4) 

#64.,Q.1OPL+2 (R4) 


Turn off carriage ctl 


An error? 
Yes if MI; display it 


R4 ; Get the response 
IOSTAT ; Check the IOSB 
EXIT 3} Exit if error 
IOLEN,FNS,RO ; Set the string length 
#BUFF,FNA,RO 3; Set the string address 
#40,Q.I1O0PL+4(R5); Restore carriage control 
FILCNT ; Init count of matches 
RO ; Parse the strings 

? 

? 


ERROR 


EXAMPLE PROGRAMS 


NOTFST: 


EXIT: 


ERROR: 


ERROR2: 


ERRORO: 


ERRORI: 


PRINT: 


SYDSKA?: 
QUES: 
ERRSTR: 


RSSST1: 
RSSSTR: 


MOV #EDBLK, R2 
SERASE RO 

SCOMPARE #0,STS,RO 
BLT ERROR 

CLR (R2) 

SFETCH (R2),RSL,R3 
TST (R2) + 
SFETCH (R2)+,RSA,R3 
MOV #RSSSTR,RL 
TST FILCNT 

BNE NOTFST 

MOV #RSSST1,R1 
CALL PRINT 

MOV #FAB, RO 

INC FILCNT 

BR GETFIL 
EXITSS 


SCOMPARE #ERSNMF,STS,RO 


, 
BNE ERRORO ; 
MOV FILCNT, (R2)+ : 
BEQ ERROR2 : 
CLR (R2) : 
SFETCH (R2),ESL,R3 ; 
TST (R2)+ ; 
SFETCH (R2),ESA,R3 ; 
MOV #TTLSTR,R1 ; 
BR ERRORL ; 
CLR -(R2) ; 
SFETCH (R2),ESL,R3 ; 
TST (R2) + ; 
SFETCH (R2),ESA,R3 ; 
MOV #NOFILE,R1 ; 
BR ERROR1 ; 
SFETCH (R2)+,STS,RO ; 
SFETCH (R2),STV,RO ; 
MOV #ERRSTR,R1 ; 
CALL PRINT ; 
JMP ERASE ; 
MOV #EDBLK, R2 ; 
MOV #BUFFER, RO ; 
CALL SEDMSG ; 
MOV #BUFFER,Q. IOPL(R5) 
MOV R1,Q.IOPL+2(R5) 
DIRS R5 ; 
RETURN ; 


-PSECT SDATAS,RW,D 


me me NO we TO te NO we NE Ne NO Ne 


me we NO Ne 


~e 


Reset the edit block addr 
Issue implicit SERASE 
Error? 

Yes if LT 

Init the length 

Get the string length 
Advance 

Get the string address 
Select the format string 
First file needs a blank 
line before it 

Insert CR/LF first 


Display the file 

Rest the FAB address 
Count this file 

And let's try another 


Task exit 


No more matches? 

No —- some other error 
Set the cound of matches 
No files... 

Give the ESA 

Set the length 

Advance word 

Set the address 

Set the format string 

Go show it and exit 


Setup for string length 
Set the length 

Advance to next word 
Set the address 

Set the format string 
Print the error 


Set the 
And the 
Set the 


STS returned 
STV 


Go edit 
Let's try this again 


Setup edit 
Output buffer 
Exit the string 


Send to the terminal 
Return to caller 


«Ascii "Sy:" 

SYDSKL = . - SYDSKA 

eAscii <15><12>"File(s) to erase: " 
QUESL = . - QUES 

-Asciz "SERASE error -- STS=%P, STV=%P" 
-Ascii "SN" 

eAsciz " File %$VA deleted" 
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error format string 


and print the message 


EXAMPLE PROGRAMS 


NOFILE: .Asciz "%NNo files matching %VA%$N" 

TTLSTR: .Asciz "%NTotal of %$D files matching %VA deleted$N" 
~ EVEN 

FILCNT: .WORD 0 

EDBLK: «BLKW 6 

BUFFER: 

BUFF: »Blkb 128. 

EXPSTR: .BLKB 128. 

RESSTR: .BLKB 128. 

IOSTAT: .WORD 0 

IOLEN: ~WORD 0 

READ: QIOWS IO.RLB,1,1,,10STAT 

WRITE: QIOWS IO.WLB,1,1,,IOSTAT, ,<,,40> 


. END ERASE 


EXAMPLE PROGRAMS 


7.4 RENAME - SRENAME TEST 


The following shows how to build the RENAME program (Example 7-4) and 
shows a brief sample run of the program. 


MAC SY:RENAME=LB: [1,1] RMSMAC/ML, SY: [uic] RENAME 
TKB 
TKB> SY: RENAME/CP=SY:RENAME,SY:GSA 
TKB>LB:SYSLIB/LB: INIDM: EXTSK 
TKB>LB: [1,1] RMSLIB/LB 
TKB>// 
RUN DB1:[200,1] RENAME 
From: DES.TMP 
To: DES. XXX 
File DBO:[70,5]DES.TMP;3 renamed to DBO: [70,5]DES.XXX;3 


Total of 1 files matching DB0O:[70,5]DES.TMP renamed 


From: ~Z 


- TITLE 
- IDENT 


. ENABL 
-MCALEL 


-MCALL 
-MCALL 


me me NO Ne 


me Ne Ne 


GSAS 


FAB1L:: FABSB 
FSDNA 
FSDNS 
FSNAM 
FSLCH 
FSFOP 
FABSE 


NAM1:: NAMSB 
NSESA 
NSESS 
NSRSA 
NSRSS 
NAMSE 


FAB2:: FABSB 
FSNAM 
FSLCH 
FABSE 


-NAM2:: . NAMSB 
NSESA 

NSESS 

NAMSE 


»PSECT 


RENAME: : 
ALUNSS 
MOV 
MOV 
MOV 
MOV 
CLR 
MOV 
MOV 
DIRS 
TSTB 
BMI 
MOV 
MOV 


EXAMPLE PROGRAMS 


Example 7-4: RENAME - SRENAME Test 


RENAME - SRENAME TEST 


/%01.00/ 
LC 


FABSB,NAMSB, GSAS 


SPARSE, SSEARCH, SRENAME, SSTORE, SFETCH , SCOMPARE 


ALUNSS,QIOWS,DIRS, 


RMS-11 Data Structures 


GSA 


SYDSKA 
SYDSKL 
NAMI | 
2. 

FBSFID 


we we 


me MO Ne 


ESSTR1 
128. 
RSSTR1 
128. 


me NO Ne MO we 


NAM2 


we te Ne 


ESSTR2 
128. 


me NO Me 


SCODES,RO,I 


#1,#"TI, #0 
#FAB1,RO0 
#EDBLK, R2 
#READ,R4 
#WRITE,R5 

Q. IOPL+4 (R5) 
#QUES1,Q. IOPL(RS) 


me me Te Me Ne te 


EXITSS 


This program tests/demonstrates the use of 
the RMS-11 SRENAME function. 


Old file name 
Default to SY: 


Link to NAM] 
Channel #2 
Turn on NAM usage 


NAM definition 
EXP STR address 
EXP STR length 
RES STR address 
RES STR length 


New file name 
Link to NAM2 
Same channel 


NAM definition 
EXP STR address 
EXP STR length 


Assign the terminal 
Map the target FAB 
Map the exit block 
Map the input DPB 
Map the output DPB 
Turn off carriage ctl 


#QUESIL,Q.IOPL+2(R5) 


R5 
LOSTAT 
EXIT 
#BUFF1,Q.IOPL(R4) 
#64.,Q.IOPL+2 (R4) 


me Ne me 


Prompt for the DNA 
Check the IOSB 
Exit if error 
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EXAMPLE PROGRAMS 


EXIT: 


LOOP: 


ERROR: 


SEAERR: 


Get the response 

Check the IOSB 

Exit if error 

Set the default length 
Set the default address 
Parse the input spec 

An error? 

Yes if LT 

Map the 2d FAB 


Prompt for the new name 
Check the I0SB 
Exit if error 


Get the response 

Check the IOSB 

Exit if error 

Set the default length 
Set the default address 
Restore carriage control 
Initialize file count 
Enter the RENAME loop 


Task exit 


Get the input FAB 
And the output FAB 
Setup NAM references 


Attempt to find a file 
Error? 

Yes if LT 

Get the resultant address 
Set this as default 

Get the resultant length 


DIRS R4 ; 
TSTB IOSTAT ; 
BMI EXIT ; 
SSTORE IOLEN,DNS,RO ; 
SSTORE #BUFF1,DNA,RO ; 
SPARSE RO ; 
SCOMPARE #0,STS,RO ; 
BLT ERROR ; 
MOV #FAB2, RO ; 
MOV #QUES2,Q. 10PL(R5) 
MOV #QUES2L,Q. IOPL+2 (R5) 
DIRS R5 ; 
TSTB IOSTAT ; 
BMI EXIT ; 
MOV #BUFF2,Q.10PL(R4) 
MOV #64.,Q.1OPL+2 (R4) 
DIRS R4 ; 
TSTB 1OSTAT ; 
BMI EXIT ; 
SSTORE IOLEN,FNS,RO ; 
SSTORE #BUFF2,FNA,RO ; 
MOV #40,Q.10PL+4(R5); 
CLR FILCNT ; 
BR LOOP ; 
EXITSS ; 
MOV #FAB1,RO 

MOV #FAB2,R1 

MOV #NAM1,R2 

MOV #NAM2,R3 

SSEARCH RO 

SCOMPARE #0,STS,RO 

BLT SEAERR 

SFETCH R4,RSA,R2 

SSTORE R4,DNA,R1 

SFETCH R4,RSL,R2 

SSTORE R4,DNS,R1 


SRENAME RO,,,R1 
SCOMPARE #0,STS,RO 


BLT 
MOV 
CLR 
SFETCH 
TST 
SFETCH 
CLR 
SFETCH 
TST 
SFETCH 
MOV 
CALL 
INC 

BR 


MOV 
SFETCH 
SFETCH 
MOV 
CALL 
JMP 


ERROR 
#EDBLK, RO 
(RO) 

(RO) ,RSL,R2 
(RO) + 

(RO) +,RSA,R2 
(RO) 

(RO), ESL,R3 
(RO) + 

(RO) ,ESA,R3 
#RENMSG, R1 
PRINT 
FILCNT 

LOOP 


mute Ne we NO we TO we TE We TO HE NO Ne TO Te NO We TH WE NO WE NO NE NE NO NE NO 


#EDBLK, R2 
(R2)+,STS,RO 
(R2) ,STV,RO 
#ERRSTR,R1 
PRINT 
RENAME 


me me we we tO Me 


Set the default length 
Rename input as output 
Error? 

Yes if LT- investigate 
Setup to show the rename 


Set the length 
Advance to next word 
Set the address 


Set the length 
Advance to next word 
Set te address 
Format string 
Display it 

Count the file 

And try another file 


Map the edit block 

Set the STS returned 

And the STV 

Set the error format string 
Go edit and print the message 
Let's try this. again 


SETES: 


TOTAL: 


PRINT: 


SYDSKA: 
QUES1: 
QUES2: 


ERRSTR: 
RENMSG: 
TTLMSG: 
NOFILE: 


FILCNT: 
EDBLK: 
BUFFER: 
BUFF 1: 
BUFF2: 
ESSTRI: 
ESSTR2: 
RSSTR1: 
IOSTAT: 
IOLEN: 
READ: 
WRITE: 


SCOMPARE #ERSNMF,STS,RO 


se me 


EXAMPLE 


End of wild card search? 


BNE ERROR No if NE- show why 
MOV #EDBLK,RO ; Map the edit block 
TST FILCNT ; Any files? 

BNE TOTAL ; Yes if NE, show total 
MOV #NOFILE,R1 3 Show the total 

CLR (RO) : 

SFETCH (RO) ,ESL,R2 ; Set the length 

TST (RO)+ ; Advance 

SFETCH (RO)+,ESA,R2 ; Get the ESA address 
CALL PRINT ; 

JMP RENAME ; Repeat 

MOV FILCNT, (RO)+ ; Set the rename count 
MOV #TTLMSG,R1 ; Set the format string 
BR SETES ; Add ESA and print 
MOV #EDBLK,R2 3 Setup edit 

MOV #BUFFER, RO ; Output buffer 

CALL SEDMSG ; Exit the string 

MOV #BUFFER,WRITE+Q.10PL 

MOV RL,WRITE+Q.IOPL+2 

DIRS #WRITE ; Send to the terminal 
RETURN 3 Return to caller 
»-PSECT SDATAS,RW,D 

-Ascii "Sy:" 

SYDSKL = . - SYDSKA 

Ascii <15><12>"From: " 

QUESIL = . = QUESIL 

Ascii <15><12>"To: " 

QUES2L = . - QUES2 

-Asciz “SRENAME error -- STS=%$P, STV=%P" 
-Asciz " File VA renamed to %VA" 

-Asciz “S$NTotal of %D files matching %VA renamed3N" 
-Asciz "$NNo files matching %VA%N" 

. EVEN 

~WORD 0 

» BLKW 6 

-BLKB 64. 

»BLKB 64 

-BLKB 128. 

-BLKB 128. 

»~BLKB 128. 

~WORD 0 

~WORD 0 

Qiows IO.RLB,1,1,,10STAT 

QIOWws IO.WLB,1,1,,10STAT, ,<,,40> 

~ END RENAME 


PROGRAMS 


EXAMPLE PROGRAMS 


7.5 GSA -- CORE SPACE ALLOCATOR 


me SO Ne Ne We Ne Ne NE me Ne Ne NO Ne we 


me Ne Ne Ne we MO Ne we Me Ne Ne Ne NO Ne NO Ne Ne Ne NO NO Ne NO Ne Ne NO TO Ne TO ND me Ne 


Example 7-5: GSA - Core Space Allocator 


-Title GSA - Core space allocator 
Ident /V02.00/ 


~Enabl LC 


Copyright (C) 1982, Digital Equipment Corporation 


Maynard, Massachusetts 01754 


**-GSA - Dynamic memory allocation for RMS-11 pool 


Called by 


RMS-11.to manage ‘pool space. 


In the event of pool exhaustion, the task 
image will be extended to obtain more space. 


May be called by user written code providing 
the interface standard is adhered to. 


Interface: 
Request space: 
RO -> RMS/user Pool list head (maintained by RL/COQB) 
Rl := Amount of space requested (bytes) 
R2 := 0O (differentiates between request and release) 
Release space: ‘ 
RO -> RMS Pool list head (maintained by RL/CQB) 
Rl := Amount of space to be released (bytes) 
R2 -> Basé address (for release) 
Returns: / 
C-Bit "set" if an error has occurred (failure) 


C-Bit "clear" if no error has occurred (success) 


-Mcall Extkss 


- Page 


-Sbttl Control block definitions 


-Psect GSASSD,RW,D 


GSA internal data: 


GSABAS - 


GSAMIN - 


GSAREQ - 


Base address for the next memory allocation. 
Initially set to zero, it will be assigned 
the first address outside of the task's 
Sey address limits. 

Decimal value reflecting the minimum size 
(in bytes) to extend the task in order to 
provide space to the pool. 

Requested pool block number. If a request 
for the 'GSAMIN' fails, then the original 
allocation size will be attempted. If that 
fails, then there is no more memory left. 
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EXAMPLE 


. 
’ 


GSABAS:: ; GSA base address 
-Word 000000 ; (for next allocation) 
GSAMIN:: ; Minimum allocation 
-Word 512./64. 3 (in 32-word blocks) 
GSAREQ:: ; Size of this request 
, 


~Word 000000 (if 'GSAMIN' extends fail) 


-Page 
-Sbttl GSA Initialization code 


~-Psect GSASSI,RO,I 


GSA Initialization 


This code is entered when GSA is entered with GSABAS 
set to zero. In order to be able to build valid pool 
header tables, GSABAS must be properly initialized and 
maintained. 


Initialization consists of finding the size of the task 

in 32-word units, and converting that value to a usable 

16-bit address (which corresponds to the address of the 

next task extension (Extk$S) call. Once GSABAS has been 
initialized, GSAINI will not be reused. 


Ne Ne Me we Me Ne we Me Ne Ne Ne Ne Ne Ne 


GSAINI: 
Mov RO,-(SP) ; RO-2 will be used to 
Mov R1,-(SP) ; communicate with SINIDM 
Mov R2,-(SP) ; NOTE: SINIDM uses EXTSK. 


The following code will use SINIDM to initialize the 
dynamic memory. As documented, Rl will return 

the first address following the task image, and R2 will 
return the size of the "free" memory from that address. 


NOTE: SINIDM and EXTSK reside in LB:[1,1]VMLIB for RSX 
systems, and in LB:SYSLIB for RSTS/E systems. 


SINIDM interface: 
Calls: 
RO -> Pool list head 


Returns: 
RO -> First address in task. 
Rl -> First address AFTER task 


mo se Me Me Ne Ne Ne MO Ne Ne Me Ne Ne Ne Ne Se Ne Ne 


R2 := Size of free core after task (based at R1) 
Call SINIDM ; Initialize dynamic memory 
Mov R1,GSABAS ; Setup the "free" address 
Mov (SP)+,R2 ; Restore the registers 
Mov (SP) +,R1 7 
Mov (SP) +,R0 ; 

Return ; And return to GSA 
.- Page 


-Sbttl GSA Mainline code 


~-Psect GSASSM,RO,I 


PROGRAMS 


EXAMPLE PROGRAMS 


me Ne me Ne Ne Ne 


GSA Mainline 


Entry point is "GSA", with registers 0-2 loaded as 
described above. 


GSA:: 


me we Ne Ne Ne Ne we we Ne NO NO Ne TO Ne 


me Ne Ne Me we Ne 


me Ne Ne Me we te Ne 


me we me Ne we NO 


First, determine if dynamic memory has been initialized. 
GSABAS (initially set to zero) will be non-zero if SINIDM 
has been called and the memory list initialized. On RSX 
based systems it is possible to install tasks with an 
extension (/INCREMENT). SINIDM will detect this and setup 
the first memory entry in the pool list. 


A point to note: If the RSX task has been installed with 
the non-checkpointable (/-CP) flag, then EXTKs will not 
return success. If it is necessary to install the task 
non-checkpointable, then the task should be installed with 
an increment value. 


Tst GSABAS ; Dynamic memory initialized? 
Bne 108 : Yes if NE, proceed 
Call GSAINI 3; Otherwise, initialize pool 


Determine if this call involves real memory. 

RL should contain the size (in bytes) of the core 
block requested or to be released. If zero then 
return to the caller without an error (TST leaves CC). 


Tst R1 ; Real memory? 
Bne 20S ; Yes if NE, then process it 
Return ; Otherwise return with success 


If this call is a request for space, pass control 

to the allocation routines. Otherwise, pass control 
to the system deallocation module SRLCB. There is 
no need to return, so control is passed via JMP. 
Note that module RQLCB resides in LB:[{1,1]SYSLIB 

for RSX11M/M-PLUS and LB:SYSLIB for RSTS/E. 


Tst R2 ; Address. specified? (release) 
Beg 308 + No if EQ, then it's a request 
JImp SRLCB ; Otherwise it's a release; do it 


Save our current context: 


RO = Pool list head 
Rl = Size of memory required 
R2 = 0 (signifies request) 


Mov RO,-(SP) 
Mov R1,-(SP) 
Mov R2,-(SP) 


mee Me we NO 


me me SO Me NO NO Ne Ne SO NO Ne NO NO Ne NO NO 


me Ne Ne Se me te 


me we Ne Ne Me Ne NO TO 


re nt et 


EXAMPLE 


Attempt an allocation from the current pool 
If this is successful, pass control to the 
common exit. 


Call SROQCB 
Bec 708 


Try the allocation 
cc signifies success 


mee 


Now that the initial allocation failed, we must extend 
the task and give the new area (extended into) to the 
caller. To do this, the following procedure is used: 


1. The task is extended 
2. The area extended is returned to the 
pool specified as if a release was attempted 
3. We retry the allocation operation, but 
this time it should succeed, since we have 
increased the size of the pool area 


NOTE: SROQCB has a bad habit of nuking registers, so it 
becomes necessary to save and restore them around 
unsuccessful calls. 


Mov 2(SP),R1 ; Obtain the request size 


Determine what the requirement is in 32-word blocks. 
Retain this value to allow GSA to decide whether 

to issue further task extension directives in 

order to satisfy the requirements. 


Ada #63.,R1 ; Round the request 

Asr Rl + to a 32-word boundary 
Asr RL + Then convert the value 
Asr R1 + to the number of 

Asr R1 ; 32-word blocks. 

Asr R1 

Asr R1 

Mov R1,GSAREQ ; Save the real size 


We will allocate core to the pool in "reasonable" 
increments to cut down on system overhead, and pool 
fragmentation. This is accomplished by using either 
the requested size, or "GSAMIN", whichever is LARGER. 
If the request is unsuccessful, and the amount is 
smaller than GSAMIN, then request that particular size. 


Cmp R1,GSAMIN ; Smaller than minimum? 
Bhi 408 ; No if HI, use it as is 
Mov GSAMIN,R1 : Otherwise use GSAMIN 


Now we attempt to extend the task by that size. 
If the request fails, then use the size of the 
original request. If that also fails, then we 
simply ran out of memory. 


ExtkSS RL ; Extend the task 


PROGRAMS 


EXAMPLE PROGRAMS 


Bee 60S ; CC if successful 

Cmp R1,GSAREQ ; Is this request? 

Blos 50s ; Yes if LOS, the end 

Mov GSAREQ,R1L ; Otherwise try to use 

Br 40S ; the actual request 
508: 

Sec ; Mark failure 

Br 70S 3 And exit 


me Ne Ne Ne Ne Ne Ne Ne Se 


The task has been extended, now this memory must be 
released to the pool for future allocation. 

To do this, we setup the registers as if RMS were 
going to release the core, and call ourself to do 


the work. 


When the area has been released to the 


pool, we will return inline and proceed to reenter 
our code again from start to reattempt the allocation. 


60S: 
Mov 4(SP) ,RO ; Setup the PLH 
Asl R1 7 Convert the real 
Asl R1 ; size to the actual 
Asl Rl 3 16-bit size that 
Asl R1 ; was allocated. 
Asl RL 3; The virtual address 
Asl RL ; should be after the 
Mov GSABAS,R2 ; task (which is now 
Add R1,GSABAS + part of the task) 
Call GSA + Call ourself to release 


At this point, the new memory has been added to the 
pool, and is available for use. We now reattempt 
to allocate the memory required. 


we Ne Ne Ne Ne 


Mov (SP)+,R2 ; Restore our registers 
Mov (SP) +,R1 ; to the initial state 

Mov (SP) +,R0 ; upon entry, and reenter 
Br GSA ; as if it's a new request 


Common exit. Leave the registers in their current state, 
and return control to the caller. 


me Ne Ne te 


Ine (SP) + ; These won't alter the 
Bit (SP)+,(SP)+ ; C-bit, so status remains 
Return ; unchanged upon return 


-End 


APPENDIX A 


COMPLETION CODES AND FATAL ERROR CODES 


Section A.1l describes RMS-1l completions that are returned in the STS 
and stv fields of FABs and RABs. . Section A.2 describes RMS-11 fatal 
error completions. 


A.1 COMPLETIONS RETURNED IN STS AND STV FIELDS 


This section lists and explains RMS-11 completions that are returned 
in the STS and STV fields of FABS and RABS. For each completion, the 
symbol, message, octal and decimal values, and explanation are given. 


sussuc 


SUSDUP 


SUSIDX 


ERSACC 


Operation succeeded Octal: 000001 
Decimal: 1 
Inserted record has duplicate key Octal: 000002 
Decimal: 2 


The PUT or UPDATE operation inserted a_ record whose key 
duplicates a key already in the index. Note that this 
completion may also be returned if a duplicate of some key in 
the new or updated record ever existed in the file, even if 
that key has since been changed or the record deleted. 


Error updating index Octal: 000003 
Decimal: 3 


The PUT or UPDATE operation inserted the record properly, but 
RMS-11. did not optimize the index structure; subsequent 
retrievals of the record will require extra 1/0 operations. 


File access error Octal: 177740 
Decimal: -32 


1. A relative or indexed file is in the initial stage of 
creation and cannot be accessed yet. 2. A write-accessed 
file was not properly closed. 3. The file processor could 
not access the file. The STV field of. the FAB contains the 
file ‘processor error code; see your operating system 
documentation for the meaning of the code. 


If the STV field contains a 0, the creation (or block access 
copy) of the relative or indexed file never completed. If the 
STV field contains a nonzero value, that value is a system 
error code indicating the reason the access was rejected. 


COMPLETION CODES AND FATAL ERROR CODES 


ERSACT 


ERSAID 


ERSALN 


ERSALQ 


ERSANI 


ERSAOP 


ERSATR 


ERSATW 


ERSBKS 


ERSBKZ 


Activity precludes operation Octal: 177720 
Decimal: -48 


RMS-11 could not perform the requested operation because of an 
activity in progress (for example, RMS-11 cannot perform the 
CLOSE operation for a file that has an - outstanding 
asynchronous operation). 


Bad value in AID field Octal: 177700 
Decimal: —64 


The file contains no area with the area number given in the 
AID field of an ALL block. 


Bad mask in ALN field Octal: 177660 
Decimal: -80 


The ALN field of an ALL block contains an invalid value. 


Bad value in ALQ field Octal: 177640 
Decimal: -96 


The ALQ field of a FAB or an ALL block contains an -invalid 
value; the value in the ALQ field is either too large, or is 
0 for an EXTEND operation. 


Bad ANSI-format magtape file Octal: 177620 
Decimal: -112 


The records in an ANSI-format magtape file are 
variable-length, but are not in the proper ANSI-D format. 


Bad mask in AOP field Octal: 177600 
Decimal: -128 


The AOP field of an ALL block contains an invalid mask value. 


Error reading attributes Octal: 177540 
Decimal: -160 


The file processor could not read the attributes for the file. 
The STV field of the FAB or RAB contains the file processor 
error code; see your operating system documentation for the 
meaning of the code. 


Error writing attributes Octal: 177520 
Decimal: ~176 


The file processor could not write the attributes for the 
file. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Bad value in BKS field Octal: 177500 
Decimal: ~192 


The value in the BKS field of the FAB is too large. 


Bad value in BKZ field Octal: 177460 
Decimal: -208 


The value in the BKZ field of an ALL block is too large; or 
the bucket sizes of the lowest (LAN) and upper (IAN) areas of 
an index are not equal. 


COMPLETION CODES AND FATAL ERROR CODES 


ERSBOF Beginning-of-file found cay Octal: 177430 
; Decimal: -232 

The SPACE operation backspaced to the beginning-of-file. 
ERSBPA Bad address in BPA field Octal: 177420 
Decimal: -240 

The value in the BPA field of the FAB is odd, and the BPS 

field contains a nonzero value. 

ERSBPS Bad value in BPS field : Octal: 177400 
Decimal: -256 

The value in the BPS field of the FAB is nonzero and not a 

multiple of 4, and the BPA field is nonzero. 

ERSCCR RAB already -in use Octal: 177340 
Decimal: -288 

The CONNECT operation could not connect a stream using the 

specified RAB because the file is sequential and does not 

allow multiple connected streams. ; 
ERSCHG Illegal record key change Octal: 177320 
Decimal: -304 

The UPDATE operation did not allow a changed record key 

because the index does not allow key changes or does not allow 

duplicate key values. 
ERSCHK Bad bucket header Octal: 177300 
Decimal: -320 

The bucket header data for an indexed file is corrupted. 

Notify your system manager, who should follow this procedure 

to recover from the error: 

1. Move the disk to a different drive and try the process 
again. If the process succeeds, the error was a hardware 
error; report the faulty hardware and continue 
processing. If the process fails again, proceed to the 
next step. 

2. Recreate the file using an RMS-ll utility (RMSIFL or 
RMSCNV). If this succeeds, the primary index and data 
records were free of errors and the new file is valid; 
continue processing. If this fails, proceed to the next 
step. 

3. Restore the file from a backup copy. 

ERSCLS File processor error Octal: 177260 
Decimal: -336 

The file processor returned an error condition to the CLOSE 

operation. The STV field of the FAB contains the file 

processor error code; see your operating system documentation 
for the meaning of the code. 


ER$COD \Bad code in COD field Octal: 177240 


Decimal: -352 


The value in the COD field of an XAB is not valid. 
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ERSCRE 


ERSCUR 


ERSDAN 


ERSDEL 


ERSDEV 


ERSDEW 


ERSDIR 


ERSDME 


ERSDNA 


ERSDNF 


File processor error Octal: 177220 
Decimal: -368 


The file processor returned an error condition to the CREATE 
operation. The STV field of the FAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Undefined current-record context Octal: 177200 
Decimal: -384 


A DELETE, TRUNCATE, or UPDATE operation required a defined 
current-record context, but it was undefined. 


Bad value in DAN field Octal: 177140 
Decimal: -416 


The value in the DAN field of a KEY block specifies a 
nonexistent area. 


Record having RFA deleted Octal: 177120 
Decimal: -432 


The record specified by RFA has been deleted. 


Bad device specification Octal: 177100 
Decimal: -448 


The device specification given contains a syntax error, there 
is no such device, the device is inappropriate for the 
operation, or two different devices have been specified for a 
RENAME operation. 


File processor error Octal: 177070 
- Decimal: -456 


The file processor returned an error while writing 
deferred-write data. The STV field of the FAB or RAB contains 
the file processor error code; see your operating system 
documentation for the meaning of the code. 


Bad directory specification Octal: 177060 
Decimal: -464 


The directory specification contains a syntax error. 


Pool exhausted Octal: 177040 
Decimal: -480 


One of the five pools that RMS-11 uses cannot provide needed 
space for the operation. 


Bad address in DNA field Octal: 177030 
Decimal: -488 


The DNA field of the FAB contains 0, but the DNS field is 
nonzero. 


No such directory Octal: 177020 
Decimal: ~496 


The directory specification given specifies a nonexistent 
directory. 


ERSDNR 


ERSDPE 


ERSDTP 


ERSDUP 


ERSENT 


ERSENV 


ERSEOF 


ERSESA 


ERSESL 


ERSESS 
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Device not ready Octal: 177000 
Decimal: -512 


The device specified is not on line. 


Device positioning error ' Octal: 176770 
Decimal: -520 


The file processor could not position the magtape device as 
specified. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Bad code in DTP field Octal: 176760 
Decimal: -528 


The value in the DTP field of a KEY block does not specify a 
valid key data type. 


Duplicate key not allowed . Octal: 176740 
Decimal: -544 


The record offered for insertion had a record key that would 
duplicate a record already in the index, but the index does 
not allow duplicate keys. 


File processor error Octal: 176720 
Decimal: -560 


The file processor could not create the specified directory 
entry. The STV field of the FAB contains the file processor 
error code; see your operating system documentation for the 
meaning of the code. : 


Feature not in selected RMS-11 environment Octal: 176700 
Decimal: -576 


The RMS-11 environment (selected with the ORGS macro or by the 
compiler or by the manner in which RMS-11 code is linked with 
your program) does not include the attempted operation for the 
specified file organization. 


End-of-file reached _ Octal: 176660 
Decimal: -592 


The operation specified a record or block that is past the 
last record or block. : 


Bad address in ESA field Octal: 176650 
Decimal: ~600 


The ESA field of the NAM block contains 0. 


Bad value in ESL field Octal: 176644 
Decimal: -604 


The ESL field of the NAM block contains 0. 


ESS field value too small Octal: 176640 
Decimal: -608 


The value in the ESS field of the NAM block specifies an 
expanded string buffer that is too small to contain the 
expanded string. 
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ERSEXP 


ERSEXT 


ERSFAC 


ERSFAL 


ERSFEX 


ERSFID 


ERSFLG 


File expiration date not yet reached Octal: 176630 
Decimal: -616. 

File processor error Octal: 176620 
: Decimal: ~624 


The file processor could not make the requested extension to 
the file. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


FAC field forbids operation . : Octal: 176560 
Decimal: -656 


The attempted record or block operation was not specified in 
the FAC field of the FAB when the file was created or opened. 


Operation not supported by remote node Octal: 176550 
Decimal: -664 


The remote node for a remote RMS-11 operation does not support 
that operation. The STV field of the FAB or RAB contains (in 
its high 4 bits) a code that gives the reason for the error: 


@ 0Q--Incompatible operating systems; the low 12 bits of the 
STV field contain the type of the remote operating system 


@® 1--Incompatible file systems; the low 12 bits of the STV 
field contain the type of the remote file system 


@ 2--DAP version number smaller than 5; the low 12 bits of 
the STV field contain the DAP version number 


e 3--DAP modification number smaller than 6; the low 12 bits 
of the STV field contain the DAP modification number 


e 4--Unsupported file organization 
@ 5--Unsupported record access 


@ 6--Operation not supported by FAL; the low 12 bits of the 
STV field contain the operation code 


@e 7--Remote I/0 buffer too small; the low 12 bits contain 
the size of the remote I/0 buffer 


File already exists Octal: 176540 
Decimal: -672 


The file specified for creation already exists, but 
supersession was not specified. 


Bad value in FID field Octal: 177530 
Decimal: -680 


The FID field of the NAM block contains a value that is not a 
file identifier. 


Bad mask in FLG field Octal: 176520 
Decimal: -688 


The combination of masks specified in the FLG field of a KEY 
block is illegal. : 


ERSFLK 


ERSFNA 


ERSFND 


ERSFNE 


ERSFNM 


ERSFOP 


ERSFUL 


ERSIAN 


ERSIDX 


ERSIFI 
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File locked by another task . Octal: 176500 
Decimal: -704 


The file sharing specified is not allowed by a task already 


accessing the file. 


Bad address in PNA field Octal: 176470 
: Decimal:  -712 


The FNA field of the FAB contains 0, but the FNS field is 
nonzero. ; 


File processor error Octal: 176460 
Decimal: -720 


The file processor could not find the file specified. The STV 
field of the FAB contains the file processor error code; see 
your operating system documentation for the meaning of the 
code. 


File not found Octal: 176440 
Decimal: -736 


The file specified for a directory or file operation does. not 
exist. 


Bad file name Octal: 176420 
Decimal: -752 


The file name portion of a file specification string has a 
syntax error. : : 


Bad mask in FOP field. Octal: 176400 
Decimal: -768 


The FOP field of the FAB contains one or more illegal masks. 


Device or file full Octal: 176360 
Decimal: -784 


The specified device or file has no room to allow file 
creation or extension. 


Bad value in IAN field Octal: 176340 
Decimal: -800 


The value in the IAN field of a KEY block specifies a 
nonexistent file area. 


Index not initialized Octal: 176320 
Decimal: -816 


This code is only returned in the STV field of the RAB in 
conjunction with the code ERS$RNF in the STS field. It 
indicates that no entries have been made in the index 
specified for the GET or FIND operation. 


Bad value in IFI field Octal: 176300 
Decimal: -832 


The value in the IFI field of the FAB is not the internal file 
identifier for a file. 
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ERS IMX 


ERS IOP 


ERSIRC 


ERSISI 


ERS KBF 


ERS$KEY 


ERSKRF 


ERSKSZ 


ERSLAN 


ERSLBL 


Too many XABs of same type Octal: 176260 
Decimal: -848 


The number of XABs of the same type in the chain of xXABs is 
too large (more than 254 ALL blocks or KEY blocks, more than 1 
DAT block, PRO block, or SUM block). 


Illegal operation for file Octal: 176220 
Decimal: -880 


The requested operation is illegal for the file organization 
or for the allowed access. 


Illegal record found in sequential file Octal: 176200 
Decimal: ~896 


The record length field of a record in a sequential file is 
invalid. 


Bad value in ISI field Octal: 176160 
Decimal: -912 


The ISI field of the RAB contains a value that is not an 
internal stream identifier. 


Bad address in KBF field Octal: 176140 
Decimal: -928 


The KBF field of the RAB contains 0. 


Bad key Octal: 176120 
Decimal: -944 


The key specified for a key access operation is invalid 


(either a negative RRN or an erroneous packed-decimal key). 


Bad value in KRF field Octal: 176100 
Decimal: -960 


The KRF field of the RAB contains (or contained) a value that 
does not specify a file index. For a key access FIND or GET 
operation, the RAB contains the invalid value in its XKRPF 
field; for a sequential access FIND or GET operation, the RAB 
contained the invalid value in its KRF field during an earlier 
CONNECT or REWIND operation. 


Bad value in KSZ field . Octal: 176060 
Decimal: -976 


The KSZ field of the RAB contains an invalid value. 


Bad value in LAN field Octal: 176040 
Decimal: -992 


The value in the LAN field of a KEY block specifies a 
nonexistent file area. 


Bad magtape label Octal: 176020 
Decimal: -1008 


The magtape does not have a valid ANSI label. 


ERSLBY 


ERSLCH 


ERSLEX 


ERSLOC 


ERSMEM 


ERSMKD 


ERSMRN 


ERSMRS 
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Logical channel busy Octal: 176000 
; Decimal: -1024 


The LCH field of the FAB contains the number of a logical 
channel that is already in use by the task. 


Bad value in LCH field. - Octal: 175760 
Decimal: -1040 


The LCH field of the FAB contains a value that is too large to 
be a logical channel number. 


Extension not needed Octal: 175750 
6 Decimal: -1048 


The. requested extension was not needed because the file area 
still contains an unused extent. 


Bad value in LOC field Octal: 175740 
Decimal: -1056 


The LOC field of an ALL block contains a value that does not 
specify a valid location. 


Memory address rollover ‘ -. Octal: 175710 
Decimal: -1080 


The area specified for the file string, default string, 
expanded string, or resultant string extends beyond the end of 
addressable memory. 


File processor error Octal: 175700 
Decimal: -1088 


The file processor could not mark the specified file for 
deletion. The STV field of the FAB contains the file 


_ processor error code; see your operating system documentation 


for the meaning of the code. 


Bad value in MRN field or bad record number Octal: 175660 
Decimal: -1104 


The MRN field of the FAB contains a negative number (CREATE 
operation), or the record number specified for a key access 
record operation is larger than the file maximum record number 
(specified in the MRN field at file creation). 


Bad value in MRS field — Octal: 175640 
Decimal: -1120 


The MRS field of the FAB contains 0 even though the file to be 
created is requested either to be a relative file or to have 
fixed-length records. 
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ERSNAE 


ERSNAM 


ERSNEF 


ERSNET 


ERSNMP 


ERSNOD 


ERSNPK 


ERSORD 


ERSORG 


Unmappable network access error Octal: 175630 
Decimal: -1128 


If this error occurs, please submit a Software Performance 
Report to DIGITAL, including the following information: 


e@e Contents of general registers and stack 


e Operation and file organization for which the error 
occurred 


e Task builder map of the task 
@ Post-mortem dump 


Bad address in NAM field Octal: 175620 
Decimal: -1136 


The NAM field of the FAB contains 0 or an odd address. 


Context not end-of-file Octal: 175600 
Decimal: -1152 


The PUT operation could not insert a record into a sequential 
file because the next-record context was not the end-of-file. 


Network link lost Octal: 175570 
Decimal: -1160 


The STV field of the FAB or RAB contains the network error 
code. 


No more matching files Octal: 175554 
Decimal: -1172 


The SEARCH operation ended the wildcard SEARCH series because 
there are no more files matching the wildcard file 
specification. 


Bad node name Octal: 175550 
Decimal: -1176 


The specified node name is invalid or, for the RENAME 
operation, the two node names are different. 


No primary key for indexed file Octal: 175540 
Decimal: -1184 


The CREATE operation did not create the specified file because 
no primary index was specified even though the request 
specified indexed file organization. 


Ordering of XABs illegal Octal: 175500 
Decimal: -1216 


The chain of XABs for a directory or file operation is 
improperly ordered. 


Bad mask in ORG field Octal: 175460 
Decimal: -1232 


The ORG field of the FAB contains an invalid file organization 
code; the file was not created. 


ERS PLG 


‘ERS PLV 


ERSPOS 


ERS PRM 


ERSPRV 


ERS RAC 


ERSRAT 


ERSRBF 
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Error reading file prologue Octal: 175440 
Decimal: -1248 

The data read from the file prologue is incorrect. 


Notify your system manager, who should follow this procedure 
to recover from the error: ‘ 


1. Move the disk to a different drive and try the process 


again. If the process succeeds, the error was a hardware 
error; report the faulty hardware and continue 
processing. If the process fails again, proceed to the 


next step. 


2. Recreate the file using an RMS-11 utility (RMSIFL or 
RMSCNV). If this succeeds, the primary index and data 
records were free of errors and the new file is valid; 
continue processing. If this fails, proceed to the next 
step. 


3. Restore the file from a backup copy. 


File prologue version level unsupported Octal: 175430 
. Decimal: -1256 


The file prologue version number shows that the file was 
created by a version of RMS that is not supported on your 
system. 


Bad value in POS field Octal: 175420 
Decimal: -1264 


The POS field of a KEY block contains a value that is greater 
than the maximum record size for the file; the STV field of 
the FAB contains the address of the KEY block. 


Bad file date read Octal: 175400 
Decimal: -1280 


The file dates read are illegal. 


Privilege violation Octal: 175360 
Decimal: -1296 


The file processor denied the requested operation because the 
task has no privilege for the operation. 


Bad mask in RAC field Octal: 175320 
Decimal: -1328 


The RAC field of the RAB contains an illegal value. 


Bad mask in RAT field Octal: 175300 
Decimal: -1344 


The RAT field of the FAB contains illegal set bits. 


Bad address in RBF field Octal: 175260 
Decimal: -1360 


The RBF field of the RAB contains an odd address; the address 
must be even for block access. 
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ERSRER 


ERSREX 


ERSRFA 
ERSRFM 


ERSRLK 


ERSRMV 


ERSRNE 


ERSRNL 


ERSROP 


File processor error Octal: 175240 
Decimal: -1376 


The file processor could not read the requested record or 
block. The STV field of the FAB or RAB contains the file 
processor error code; see your operating system documentation 
for the meaning of the code. 


Record already exists Octal: 175220 
? Decimal: -1392 


The target cell for a PUT operation to a relative file already 
contains a record. 


Bad value in RFA field . Octal: 175200 
Decimal: -1408 


The RFA field of the RAB contains an illegal RFA. 


Bad code in REM field Octal: 175160 
Decimal: -1424 


The RFM field of the FAB contains an illegal value. 


Record locked Octal: 175140 
Decimal: -1440 


The bucket containing the specified record is locked by 
another task or by another stream in your task. 


File processor error Octal: 175120 

Decimal: -1456 
The file processor could not delete the specified directory 
entry. The STV field of the FAB contains the file processor 
error code; see your operating system documentation for the 
meaning of the code. 


No such record . Octal: 175100 
Decimal: -1472 


The record specified for key access does not exist. 


Record not locked . Octal: 175060 
Decimal: -1488 


The FREE operation found that no record was locked for the 
stream. 


Bad mask in ROP field Octal: 175040 
Decimal: -1504 


The ROP field of the RAB contained illegal set bits. 


ERSRPL 


ERSRRV 


ERSRSL 


ERSRSS 


ERSRST 


ERSRSZ 


ERSRTB 
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File processor error Octal: 175020 
Decimal: -1520 

The data read from the file prologue is incorrect. 


Notify your system manager, who should follow this procedure 
to recover from.the error: ae 


1. Move the disk to a different drive and try the process 


again. If the process succeeds, the error was a hardware 
error; report the faulty hardware and continue 


processing. If the. process fails again, proceed to the 
next step. ; : 


2. Recreate the file using an RMS-11 utility (RMSIFL or 
RMSCNV). If this succeeds, the primary index and data 
records were free of errors and the new file is valid; 
continue processing. If this fails, proceed to the next 
step. 


3. Restore the file from a backup copy. 


Bad. internal pointer Octal: 175000 
‘Decimal: --1536 


An internal pointer in the file is invalid. Reload the file, 
with RMSCNV or RMSIFL, using its primary index. 


Bad value in RSL field Octal: 174754 
Decimal: -1556 


The RSL field of the NAM block contains 0. 


Bad value in RSS field Octal: 174750 
Decimal: -1560 


The RSS field of the NAM block contains 0. 


Bad address in RSA field - eS Octal: 174744 
Decimal: -1564 


The RSA field of the NAM block contains. 0. 


Bad value in RSZ field Octal: 174740 
, Decimal: -1568 


The RSZ field of the RAB contains a value that is larger than 
the maximum allowed record size, or (for fixed-length records) 
is not equal to the maximum record size, or (for an UPDATE 
operation to a sequential file) is not equal to the length of 
the record to be updated. 


Record too big for user buffer ‘Octal: 174720 
; , Decimal: -1584 


‘The record’ read cannot fit into the user buffer; the STV. 


field of the RAB contains the size of the record, and the 
portion that will fit is moved to the user buffer as for a 
successful GET. , 
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ERSRVU 


ERSSEQ 


ERSSHR 


ERSSIZ 


ERSSUP 


ERSSYS 


ERSTRE 


ERSTYP 


ERSUBF 


Internal pointer corrupted Octal: 174710 
Decimal: -1592 


The record insertion succeeded and the primary index was 
updated successfully; however, RMS-11 could not update 
internal pointers. 

To recover from the error, follow this procedure: 

1. Recreate the file using an RMS-11 utility (RMSIFL or 
RMSCNV). If this succeeds, the primary index and data 
records were free of errors and the new file is valid; 
continue processing. If this fails, proceed to the next 
step. 

2. Restore the file from a backup copy. 


Sequential insertion records not in order Octal: 174700 
Decimal: -1600 


The sequential access PUT operation found records whose 
primary keys were not in ascending order. 


Bad mask in SHR field Octal: 174660 
Decimal: -1616 


The SHR field of the FAB contains an illegal mask. 


Bad value in SIZ field Octal: 174640 
Decimal: -1632 


The SIZ field of a KEY block contains an illegal value. 


Operation not supported over network Octal: 174610 
Decimal: -1656 


The requested operation is not supported over the network. 


System error Octal: 174600 
Decimal: -1664 

The interface between RMS-11 and the system is in error; the 

STV field of the FAB or RAB contains the status code for a 

system directive. Please submit a Software Performance 

Report. 

Index error Octal: 174560 


Decimal: -1680 


The index contains invalid data. Build a new file using 
either an RMS-11 utility (RMSIFL or RMSCNV) or using 
sequential access and the primary index to fetch the old 
records. 


Bad file type Octal: 174540 
Decimal: -1696 


The file type in a file specification contains invalid syntax. 


Bad address in UBF field Octal: 174520 
Decimal: -1712 


The UBF field of the RAB contains 0 or, for block access, an 
odd address. 


ERSUIN 


ERSUSZ 


ERSVER 


ERSWCD 


ERSWER 


ERSWLK 


ERSWPL 


ERSXAB 


ERSXTR 
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Field value rejected by FAL Octal: 174510 
Decimal: -1720 


The FAL (file access listener) rejected the value in a control 
block field; the STV field of the FAB or RAB contains a code 
showing which field. See your DECnet documentation for the 
meanings of these codes. 


Bad value in USZ field Octal: 174500 
Decimal: -1728 


The USZ field of the RAB contains 0. 


Bad file version number Octal: 174460 
Decimal: -1744 


The file version portion of a file specification contains a 
syntax error. 


Illegal wildcard in merged string Octal: 174430 
Decimal: -1768 


The merged string contains a wildcard character, but 
wildcearding is not in progress or is illegal for the 
operation. 


File processor error Octal: 174420 
Decimal: -1776 


The file processor could not write to the file. The STV field 
of the FAB or RAB contains the file processor error code; see 
your operating system documentation for the meaning of the 
code. 


Device write-locked Octal: 174410 
Decimal: -1784 


The device specified is write-locked. 


File processor error Octal: 174400 
Decimal: -1792 


The file processor could not write the file prologue. The STV 
field of the FAB or RAB contains the file processor error 
code; see your operating system documentation for the meaning 
of the code. 


Bad address in XAB field Octal: 174360 
Decimal: -1808 


The XAB field of the FAB contains an odd address. 


Extraneous data in file specification Octal: 174340 
Decimal: -1824 


The file specification contains extraneous characters. The 
value in the STV field of the FAB is the address of the first 
character beyond the end of the valid file specification. 
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A.2 FATAL ERROR COMPLETIONS 


This section lists and explains RMS-11 completions that are returned 
in general register RO. These errors are fatal either because RMS-11 
detected an internal error condition and could not continue, or 
because the RAB or FAB is of questionable validity and RMS-11 
therefore did not write the completion in its fields. 


ERSACT Illegal concurrent operation Octal: 177720 
Decimal: -48 

1. The FAB you specified is already in use by another 
operation, 2s You have illegally interrupted RMS-11l 


processing. 


ERSAST Illegal operation at AST level Octal: 177560 
Decimal: -144 


Your program attempted to use WAIT operation at AST level. 


ERSBUG Error in RMS-11 internal data Octal: 177360 
Decimal: -272 
RMS-11 detected an error in its internal data structures. The 


error may have been caused by your task writing into the 
structures; if you think your task did not cause the error, 
Please submit a Software Performance Report to DIGITAL, 
including the following information: 


e Contents of general registers and stack 


@ Operation and file organization for which the error 
occurred 


e Task builder map of the task 
@ Post-mortem dump 


ERSCPB Bad parameter block Octal: 177230 
Decimal: | -360 


The parameter block (pointed to by R5) for an operation macro 
has an invalid argument count or is at a zero or odd address. 


ERSFAB Bad FAB Octal: 176600 
Decimal: -640 


The value in the BID or BLN field of the specified FAB is not 
the correct identifier or block length for a FAB, or the 
address of the FAB is 0 or odd. 


ERSLIB Resident library not available Octal: 175744 
Decimal: -1052 


The version of the RMS-11 resident library needed for your 
task is not available. 


ERSMAP 


ERSRAB 
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Error in internal buffer mapping data Octal: 175720 
Decimal: -1072 


RMS-11 detected an error in its internal data structures. The 
error may have been caused by your task writing into the 
Structures; if you think your task did not cause the error, 
please submit a Software Performance. Report to DIGITAL, 
including the following information: “3 


e Contents of general registers and stack 


@e Operation and file organization for which the error 
occurred 


e Task builder map of the task 
@ Post-mortem dump 


Bad RAB Octal: 175340 
Decimal: -1312 


The value in the BID or BLN field of the specified RAB is not 
the correct identifier or block length for a RAB, or the 
address of the RAB is 0 or odd. 
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ASSEMBLY-TIME MESSAGES 


RMS-11 macros detect some errors during assembly. For each such 
error, the macro issues a .PRINT or .ERROR assembler directive with a 
message. This appendix shows these messages and their meanings. 


SCOMPARE MACRO - FIELD TOO LARGE 


You can specify only a 1l-byte or 1l-word field as the field 
parameter for the SCOMPARE macro. 


SCOMPARE MACRO - FIELD PARAMETER INVALID 


You must specify a valid field mnemonic as the field parameter 
for the SCOMPARE macro. 


SFETCH MACRO - PC DESTINATION INVALID 


You cannot specify the PC as the destination for the SFETCH 
macro. 


SFETCH OR SSTORE MACRO - ADDRESS MODE INVALID 
You have used an illegal address mode in the source for a SSTORE 
macro or in the destination for a SFETCH macro. See Chapter 3 
for a description of legal address modes for these macros. 


SFETCH OR SSTORE MACRO - FIELD PARAMETER INVALID 


You can specify only a valid field mnemonic as the field 
parameter for a field access macro. 


SFETCH OR SSTORE MACRO - FIELD TOO LARGE FOR GIVEN REGISTERS 
You cannot specify the given register as _ the source or 
destination address because the field is larger than the 
remaining registers. 


SFETCH OR SSTORE MACRO — FIELD TOO LARGE FOR IMMEDIATE MODE 


You can specify an immediate mode value for a field access macro 
only if you specify a 1-byte or l-word field. 


SFETCH OR SSTORE MACRO - FIELD TOO LARGE FOR REGISTERS 


You cannot specify a register as the source or destination 
address because the given field is too large. 
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SFETCH OR SSTORE MACRO — REGISTER PARAMETER INVALID 


You can specify only RO, Rl, R2, R3, R4, or R5 as the register 
parameter for a field access macro. 


SFETCH OR SSTORE MACRO — REGISTER USAGES OVERLAP 
You cannot specify the given register as_ the source or 
destination address because the indicated registers overlap the 
register containing the control block address. 


SOFF MACRO - FIELD TOO LARGE 


You can specify only a l-byte or l-word field as the field 
parameter for the SOFF macro. 


SOFF MACRO —- FIELD PARAMETER INVALID 


You must specify a valid field mnemonic as the field parameter 
for the SOFF macro. 


SSET MACRO - FIELD TOO LARGE 


You can specify only a l-byte or 1-word field as the field 
parameter for the SSET macro. 


SSET MACRO - FIELD PARAMETER INVALID 


You must specify a valid field mnemonic as the field parameter 
for the $SET macro. 


SSETGSA MACRO - REGISTER PARAMETER INVALID 


You must specify RO, Rl, R2, R3, R4, or R5 as the register 
parameter for the SSETGSA macro. 


STESTBITS MACRO - FIELD TOO LARGE 


You can specify only a 1-byte or 1l-word field as the field 
parameter for the STESTBITS macro. 


STESTBITS MACRO - FIELD PARAMETER INVALID 


You must specify a valid field mnemonic as the field. parameter 
for the STESTBITS macro. 


FSBSZ MACRO - BSZ FIELD NOT USED IN RMS-11 


RMS-11 has no BSZ field in the FAB; therefore the FSBSZ macro 
cannot initialize the field. 


FSJFN MACRO - JFN FIELD NOT USED IN RMS-11 


RMS-11 has no JFN field in the FAB; therefore the FSJFN macro 
cannot initialize the field. : 


FABSB MACRO —- ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the FABSB macro to begin FAB declaration until you 
have ended the current block or pool declaration (using the 
FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 

FABSB MACRO - FAB NOT WORD-ALIGNED 
Use the .EVEN assembler directive before the FABSB macro; this 


assures word-alignment for the FAB. 


B-2 


ASSEMBLY-TIME MESSAGES 


FABSE MACRO —- NOT IN FAB DECLARATION 


You must begin a FAB declaration with the FABSB macro before 
ending it with a FABSE macro. 


NAMSB MACRO - ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the NAMSB macro to begin NAM block declaration 
until you have ended the current block or pool declaration (using 
the FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 

NAMSB MACRO - NAM BLOCK NOT WORD-ALIGNED 


Use the .EVEN assembler directive before the NAMSB macro; this 
assures word-alignment for the NAM. 


NAMSE MACRO ~ NOT IN NAM BLOCK DECLARATION 


You must begin a NAM block declaration with the NAMSB macro 
before ending it with a NAMSE macro. 


OPERATION MACRO - FAB OR RAB ADDRESS PARAMETER MISSING 
You must specify a control block address for the operation macro; 
for a file operation, specify a FAB address; for a stream, 
record, or block I/O operation, specify a RAB address. 


ORGS MACRO - OPERATION PARAMETER INVALID 


You can specify only CRE, DEL, FIN, GET, PUT, and UPD as 
operation parameters for the ORGS macro. 


ORGS MACRO - ORGANIZATION PARAMETER INVALID 


You can specify only IDX, REL, or SEQ as the organization 
Parameter for the ORGS macro. 


ORGS MACRO - ORGANIZATION PARAMETER MISSING 


You must specify IDX, REL, or SEQ as the organization parameter 
for the ORGS macro. 


POOLSB MACRO - ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the POOLSB macro to begin pool declaration until 
you have ended the current block or pool declaration (using the 
FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 

POOLSE MACRO - NOT IN POOL DECLARATION 


You must begin a POOL declaration with the POOLSB macro before 
ending it with a POOLSE macro. 


RSLSN MACRO - LSN FIELD NOT USED IN RMS-11 


RMS-11 has no LSN field in the RAB; therefore the RSLSN macro 
cannot initialize the field. 


RABSB MACRO ~- ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the RABSB macro to begin RAB declaration until you 


have ended the current block or pool declaration (using the 
FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 


ASSEMBLY-TIME MESSAGES 


RABSB MACRO —- RAB NOT WORD-ALIGNED 


Use the .EVEN assembler directive before the RABSB macro; this 
assures word-alignment for the RAB. 


RABSB MACRO - RAB TYPE PARAMETER INVALID 


You can specify only SYN, ASYN, or a null as the parameter for 
the RABSB macro, 


RABSE MACRO -— NOT IN RAB DECLARATION 


You must begin a RAB declaration with the RABSB macro before 
ending it with a RABSE macro. 


XSSIZ MACRO - TOTAL KEY SIZE TOO LARGE 


The sum of the segment sizes for a key is greater than 255. 
Specify smaller segments. 


XABSB MACRO —- ALREADY IN BLOCK OR POOL DECLARATION 
You cannot use the XABSB macro to begin XAB declaration until you 
have ended the current block or pool declaration (using the 
FABSE, NAMSE, POOLSE, RABSE or XABSE macro). 

XABSB MACRO —- XAB NOT WORD-ALIGNED 


Use the .EVEN assembler directive before the XABSB macro; this 
assures word-alignment for the XAB. 


XABSB MACRO - XAB TYPE PARAMETER INVALID 


You can specify only XBSALL, XBSDAT, XBSKEY, XBSPRO, or XBSSUM as 
the XAB type parameter for the XABSB macro. 


XABSE MACRO - NOT IN XAB DECLARATION 


You must begin a XAB declaration with the XABSB macro before 
ending it with a XABSE macro. 


APPENDIX C 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-l lists RMS-ll -macros (and their arguments) that declare 
symbols and other macros. In the table, the expression xxx represents 
a 2- or 3-character string, so that the expression O$xxx represents 
all symbols that begin with OS; the expression fld represents a field 
mnemonic. 


Note that you can declare symbols either globally or locally. For a 
FABSBT, RABSBT, XABSBT, or SRMSTAT macro, give the argument DFINSG (or 
omit the argument) to define symbols globally; give the argument 
DFINSL to define symbols locally. 


Note also that you can declare symbols for control block sizes without 
declaring field-offset symbols. For a FABOFS, NAMOFS, RABOFS, XABOFS, 
XBAOFS, XBDOFS, XBKOFS, XBPOFS, or XBSOFS$ macro, give the argument 
DEFSSZ to define only symbols for block sizes, or give no argument to 
define both symbols for block sizes and field-offset symbols. 


Table C-1l: Macros That Declare Symbols and Other Macros 


a 


Macro Argument Declares 
FABSB — FAB field-initialization macros: of the form 
FSfld 


- FAB end-block-declaration macro: FABSE 
- FAB field-offset symbols: of the form OSfld 
- FAB code and mask symbols: of the form 


FBSxxx 

FABSBT DFINSG - Global FAB code and mask symbols: of the 
form FBSxxx (except FAB length symbol 
FBSBLN) 

FABSBT DFINSL - Local FAB code and mask symbols: of the form 


FBSxxx (except FAB length symbol FBSBLN) 


FABOFS - FAB field offset symbols: of the form O$fld 
- FAB length symbol: FBSBLN 


FABOFS DEFSSZ - FAB length symbol: FBSBLN 


(Continued on next page) 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-1 (Cont.): Macros That Declare Symbols and Other Macros 


Macro Argument Declares 


SFBCAL 


SGNCAL 


NAMSB 


NAMOFS 


NAMOEF'S DEFSSZ 


POOLSB 


RABSB 


RABSBT DFINSG 


RABSBT DFINSL 


RABOFS 


RABOFS DEFSSZ 


Directory operation macros: SENTER, S$PARSE, 
SREMOVE, SRENAME, and SSEARCH i 

File operation macros: SCLOSE, SCREATE, 
SDISPLAY, SERASE, SEXTEND, and SOPEN 


Get-space address macros: GSAS, SGETGSA, and 
SSETGSA 

Facilities-—declaration macro: ORGS 

RMS-11 initialization macros: SINIT and 
SINITIF (obsolete) 

Field-access macros: SCOMPARE, SFETCH, SOFF, 
SSET, SSTORE, and STESTBITS 
Completion-handler return macro: SRETURN 


NAM block field-initialization macros: of 
the form NSfld 

NAM block end—block-—declaration macro: NAMSE 
NAM block field-offset symbols: of the form 
osfld 

NAM block code and mask symbols: of the form 
NBSxxx 


NAM block field offset symbols: of the form 
OSsfld 
NAM block length symbol: NBSBLN 


NAM block length symbol: NBSBLN 


Pool declaration macros: PSBDB, PSBUF, 
PSFAB, PSIDX, PSRAB, and PSRABX 
End-pool-declaration macro: POOLSE 


RAB field-initialization macros: of the form 
RSfld 

RAB end-block-declaration macro: RABSE 

RAB field-offset symbols: of the form OSfld 
RAB code and mask symbols: of the form 
RBSxxx 


Global RAB code and mask symbols: of the 
form RBSxxx (except RAB length symbol RBSBLN 
or RBSBLL) 


Local RAB code and mask symbols: of the form 
RBSxxx (except RAB length symbol RBSBLN or 
RBSBLL) 


RAB field offset symbols: of the form OSfld 
RAB length symbol: RBSBLN (for synchronous 
RAB) or RBSBLL (for asynchronous RAB) 

RAB length symbol: RBSBLN (for synchronous 
RAB) or RBSBLL (for asynchronous RAB) 


(Continued on next page’ 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-1 (Cont.): Macros That Declare Symbols and Other Macros 


a 


Macro 


eee te 


SRBCAL 


SRMSTAT 


SRMSTAT 


XABSB 


XABSB 


XABSB 


XABSB 


XABSB 


Argument Declares 


DFINSG 


DFINSL 


XBSALL 


XBSDAT 


XBSKEY 


XBSPRO 


XBSSUM 


Stream operation macros: SCONNECT, 
SDISCONNECT, SFLUSH, SFREE, SNXTVOL, 
SREWIND, and SWAIT 

Record operation macros: SDELETE, $FIND, 
SGET, SPUT, STRUNCATE, and SUPDATE 

Block operation macros: $READ, S$SPACE, and 
SWRITE 


Global completion symbols: of the forms 
ERSxxx and SUSxxx 


Local completion symbols: of the forms 
ERSxxx and SUSxxx 


ALL block field-initialization macros: of 
the form xSfld 

XAB- end-block-declaration macro: XABSE 

ALL block field-offset symbols: of the form 
oOsfld 

XAB code and mask symbols: of the form 
XBSxxx 


DAT block field-initialization macros: of 
the form XSfld 

XAB end-block-declaration macro: XABSE 

DAT block field-offset symbols: of the form 
Osfld : 
XAB code and mask. symbols: of the form 
XBSxxx 


KEY block field-initialization macros: of 
the form xSfld 

XAB end-block-declaration macro: XABSE 

KEY block field-offset symbols: of the form 
osfild 

XAB code and mask symbols: of the form 
XBSxxx 


PRO block field-initialization macros: of 
the form XSfld 

XAB end-block-declaration macro: XABSE 

PRO block field-offset symbols: of the form 
OSfld 

XAB code and mask symbols: of the form 
XBSxxx 


SUM block field-initialization macros: of 
the form xXSfld 

XAB end-block-declaration macro: XABSE 

SUM block field-offset symbols: of the form 
osfld 

XAB code and mask symbols: of the form 
XBSxxx 


(Continued on next page) 


MACROS THAT DECLARE SYMBOLS AND OTHER MACROS 


Table C-1 (Cont.): 


Macro 


XABSBT 


XABSBT 


XABOFS 


XABOFS 


XBAOFS 


XBAOFS 


XBDOFS 


XBDOFS 


XBKOFS 


XBKOFS 


XBPOFS 


XBPOFS 


XBSOFS 


XBSOFS 


Argument 


DFINSG 


DFINSL 


DEFSSZ 


DEFSSZ 


DEFSSZ 


DEFSSZ 


DEFSSZ 


DEFSSZ 


Macros That Declare Symbols and Other Macros 
Declares 
Global XAB code and mask symbols: of the 
form XBSxxx (except XAB length symbols: 
XBSLAL, XBSDTL, XBSKYL, XBSPRL, and XBSSML) 
Local XAB code and mask symbols: of the form 
XBSxxx (except XAB length symbols: XBSLAL, 
XBSDTL, XBSKYL, XBSPRL, and XBSSML) 
XAB field offset symbols: of the form OSfld 
XAB length symbols: XBSLAL, XBSDTL, XBSKYL, 
XBSPRL, and XBSSML 
XAB length symbols: XBSLAL, XBSDTL, XBSKYL, 
XBSPRL, and XBSSML 
ALL block field offset symbols: of the form 
OSfld 
ALL block length symbol: XBSLAL 
ALL block length symbol: XBSLAL 
DAT block field offset symbols: of the form 
OSfld 
DAT block length symbol: XBSDTL 
DAT block length symbol: XBSDTL 
KEY block field offset symbols: of the form 
OSsfld 
KEY block length symbol: XBSKYL 
KEY block length symbol: XBSKYL 
PRO block field offset symbols: of the form 
OSfld 
PRO block length symbol: XBSPRL 
PRO block length symbol: XBSPRL 
_SUM block field offset symbols: of the form 
OSfld 
SUM block length symbol: XBSSML 
SUM block length symbol: XBSSML 


APPENDIX D 


RMS-11 WITH DIFFERENT OPERATING SYSTEMS 


This appendix contrasts the behaviors of RMS-11 on different operating 
systems: 


@ PRO/RMS-11 versus RSTS/E RMS-11 
@ PRO/RMS-11 versus RSX-11M/M-PLUS RMS-11 


@ RSTS/E RMS-11 versus RSX-11M/MPLUS RMS-11 


D.1 PRO/RMS-11 VERSUS RSTS/E RMS-11 


This section contrasts the behaviors of PRO/RMS-11 and RSTS/E RMS-11l. 


D.1.1 Different Behaviors 
The following features behave differently for RSTS/E and P/OS users: 
e Macro library location 


RMS-11 macro libraries for the systems are located in the 
files: 


RSTS/E LB: RMSMAC .MLB 
P/OS LB: {1,1]RMSMAC.MLB 


e@ RTV field in FAB 
The RTV field in the FAB has different uses: 


RSTS/E Cluster size 
P/OS Retrieval pointer count 


@ Maximum bucket size 


The maximum bucket sizes (given by the BKS field in the FAB or 
the BKZ fields in ALL blocks) are different: 


RSTS/E 15 blocks 
P/OS 32 blocks 


RMS-11 WITH DIFFERENT OPERATING SYSTEMS 


Area alignment 


The meanings of area alignment codes (in the ALN field of an 
ALL block) are different: 


RSTS/E XBSLBN Cluster alignment 

P/OS XBSCYL Cylinder alignment 
XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


® Protection codes 


The protection codes (and defaults) are system-specific. 


D.1.2 Features Not Supported on RSTS/E 


The following RMS~1l features are not supported on RSTS/E, but are 
supported on P/OS: 


@ ENTER operation (SENTER macro) 

e NXTVOL operation (S$NXTVOL macro) 

e@ REMOVE operation (SREMOVE macro) 

@e SPACE operation (S$SPACE macro) 

e WAIT operation (SWAIT macro) 

e User-provided interlocking (FBSUPI mask in SHR field of FAB) 

e File version numbers (NBSVER mask in FNB field of NAM) 

e Asynchronous execution of operations (RBSASY mask in ROP field 
of RAB; SYN and ASYN arguments to RABSB macro; RBSBLL symbol 
for length of asynchronous RAB) 

@ Directories (DID field in NAM block) 

® Area extension (ALL block fields for SEXTEND macro) 


e Contiguous file extension (FBSCTG mask in FOP field of FAB for 
SEXTEND macro) 


e Hard placement (XBSHRD mask in AOP field of ALL block) 


@ Return of date and protection information by DISPLAY operation 
(PRO block fields and DAT block fields for SDISPLAY macro) 


e File expiration date (EDT field of NAM block) and file 
revision number (RVN field of NAM block) 


D.1.3 Features Not Supported on P/OS 


On RSTS/E, for compatibility with older file system, RMS~11l treats 
certain sequential files with undefined records as sequential files 
with stream records. P/OS will allow only block access to such files. 
In addition, magtape devices are not supported on P/OS, and remote 
operations are not supported on P/OS. 


RMS-11 WITH DIFFERENT OPERATING SYSTEMS — 


D.2 PRO/RMS-11 VERSUS RSX-11M/M-PLUS RMS-11 


The P/OS operating system does not support magtape devices or remote 
RMS-11 operations. 


P/OS files have decimal version numbers (NBSVER mask in FNB field of 
NAM). 


D.3 RSTS/E RMS-11 VERSUS RSX-11M/M-PLUS RMS-11 


This section contrasts the behaviors of RSTS/E RMS-11 and 
RSX-11M/M-PLUS RMS-11. 


D.3.1 Different Behaviors 


The following features behave differently for RSTS/E and 
RSX-11M/M-PLUS users: 


@ Macro library location 


RMS-1l macro libraries for the systems are located in the 
files: 


RSTS/E LB:RMSMAC .MLB 
RSX-11M/M-PLUS LB: [1,1] RMSMAC.MLB 


e RTV field in FAB 
The RTV field in the FAB has different uses: 


RSTS/E Cluster size 
RSX-11M/M-PLUS Retrieval pointer count 


e Maximum bucket size 


The maximum bucket sizes (given by the BKS field in the FAB or 
the BKZ fields in ALL blocks) are different: 


RSTS/E 15 blocks 
RSX-11M/M-PLUS 32 blocks 


e Area alignment 


The meanings of area alignment codes (in the ALN field of an 
ALL block) are different: 


RSTS/E XBSLBN Cluster alignment 
RSX-11M/M-PLUS XBSCYL Cylinder alignment 


XBSLBN Logical block alignment 
XBSVBN Virtual block alignment 


RMS-11 WITH DIFFERENT OPERATING SYSTEMS 


D.3.2 Features Not Supported on RSTS/E 


The following RMS-11 features are not supported on RSTS/E, but are 
supported on RSX-11M/M-PLUS: 


ENTER operation (SENTER macro) 

@ NXTVOL operation (SNXTVOL macro) 

@ REMOVE operation (SREMOVE macro) 

@ REWIND operation for magtape device (SREWIND macro) 

@® SPACE operation (S$SPACE macro) 

@® WAIT operation (SWAIT macro) 

@ User-provided interlocking (FBSUPI mask in SHR field of FAB) 

e Octal file version numbers (NBSVER mask in FNB field of NAM) 

e Asynchronous execution of operations (RBSASY mask in ROP field 
of RAB; SYN and ASYN arguments to RABSB macro; RBSBLL symbol 
for length of asynchronous RAB) 

@® Directories (DID field in NAM block) 


e Area extension (ALL block fields for SEXTEND macro) 


e Contiguous file extension (FBSCTG mask in FOP field of FAB for 
SEXTEND macro) 


e Hard placement (XBSHRD mask in AOP field of ALL block) 


e Return of date and protection information by DISPLAY operation 
(PRO block fields and DAT block fields for SDISPLAY macro) 


e File expiration date (EDT field in NAM block) and file 
revision number (RVN field of NAM block) 


e Initial end-of-file context for magtape file (FBSNEF mask in 
FOP field of FAB for SOPEN macro) 


e Multivolume magtapes 


SCLOSE macro, 5-3 
SCOMPARE macro, 2-17 
example, 7-3, 7-7, 
SCONNECT macro, 5-6 
SCREATE macro, 5-9 
SDELETE macro, 5-25 
SDISCONNECT macro, 5-27 
SDISPLAY macro, 5-29 
RSTS/E, D-4 
SENTER macro, 
RSTS/E, D-4 
SERASE macro, 5-40 
example, 7-11 
SEXTEND macro, 
RSTS/E, D-4 
SFBCAL macro, C-2 
SFETCH macro, 2-16 
example, 7-3, 7-7, 
SFIND macro 
key access, 5-51 
RFA access, 5-54 
sequential access, 
SFLUSH macro, 5-56 
SFREE macro, 5-58 
SGET macro 
key access, 5-63 
RFA access, 5-67 
sequential access, 
SGETGSA macro, 2-21 
SGNCAL macro, C-2 
SINIT macro (obsolete), xiv 
SINITIF macro (obsolete), xiv 
SNXTVOL macro, 5-70 
RSTS/E, D-4 
SOFF macro, 2-12 
SOPEN macro, 5-72 
RSTS/E, D-4 
SPARSE macro, 5-86 
example, 7-3, 7-7, 
$PUT macro 
key access, 5-95 
sequential access, 
SRBCAL macro, C-3 
SREAD macro 
sequential access, 5-98 
VBN access, 5-100 
SREMOVE macro, 5-102 
RSTS/E, D-4 
SRENAME macro, 
example, 7-15 
SRETURN macro, 2-20 
SREWIND macro, 5-114 
RSTS/E magtape device, D-4 
SRLCB system routine, 2-22 
SRMSTAT macro, C-3 
SRQCB system routine, 2-22 
SSEARCH macro, 5-116 
example, 7-7, 7-15 
SSET macro, 2-12 
SSETGSA macro, 2-20 
SSPACE macro, 5-120 


7-11, 7-15 


5-35 
5-46 
7-15 


7-11, 


5-49 


5-60 


7-11, 7-15 


5-91 


5-108 


INDEX 


RSTS/E, D-4 
SSTORE macro, 2-11 
example, 7-3, 7-7, 
STESTBITS macro, 2-18 
STRUNCATE' macro, 5-122 
SUPDATE macro, 5-124 
SWAIT macro, 5-126 
RSTS/E, D-4 
SWRITE macro 
sequential access, 
VBN access, 5-129 
~EVEN assembler directive 


7-11, 


5-127 


control block alignment, 2-8 


pool alignment, 2-4 
».MCALL assembler directive, 
/ML assembler switch, 2-22 


Access 
requested 
See FAC 
shared 
See SHR 
Access mode 
block 
See BKT 
record 
See RAC field in RAB 
AID field in ALL block, 
CLOSE operation, 5-3 
CREATE operation, 5-9, 
DISPLAY operation, 5-30 
ENTER operation, 5-35 
ERASE operation, 5-40 


field in FAB 


field in FAB 


field in RAB 


2-13 


5-16 


EXTEND operation, 5-46 to 5-47 


offset, 6-2 
OPEN operation, 
PARSE operation, 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-3 
Alignment 
See ALN field in ALL block 
ALL block 
chaining to FAB, 
declaring, 2-8 
initializing, 
summary, 6-2 
Allocation 
See ALQ field in ALL block 
See ALQ field in FAB 
XAB 
See ALL block 
ALN field in ALL block 
CREATE operation, 5-17 
DISPLAY operation, 5-30 
EXTEND operation, 5-47 
offset, 6-2 
OPEN operation, 
RSTS/E, D-4 
summary, 6-4 


5-73 
5-86 


2-13 


2-10 


5-79 


Index-1 


7-15 


ALQ field in ALL block 
CREATE operation, 5-16, 5-21 
DISPLAY operation, 5-30 
EXTEND operation, 5-47 
offset, 6-2 
OPEN operation, 5-79 
RSTS/E, D-4 
summary, 6-5 

ALQ field in FAB 
CREATE operation, 5-16, 5-21 


EXTEND operation, 5-46 to 5-47 


offset, 6-22 
OPEN operation, 5-78 
summary, 6-25 

ALQO field in ALL block 
offset, 6-2 

ALQ1 field in ALL block 
offset, 6-2 

ANSI magtape device, 3-2, 5-20, 
5-37, 5-43, 5-77, 5-88, 
5-104, 5-111, 5-118 

AOP field in ALL block 


CREATE operation, 5-17 to 5-18 


DISPLAY operation, 5-30 
EXTEND operation, 5-47 
offset, 6-2 
OPEN operation, 5-79 
RSTS/E, D-4 
summary 

XBSCTG mask, 6-6 

XBSHRD mask, 6-7 

Area 

alignment 

See ALN field in ALL- block 
allocation 

See ALQ field in ALL block 
bucket size 

See BKZ field in ALL block 
contiguity 


See XBSCTG mask in AOP field 


count 
See NOA field in SUM block 
default extension size 
See DEQ field in ALL block 
description, obtaining 
See DISPLAY operation 
extending allocation 
See EXTEND operation 
identifier 
See AID field in ALL block 
location 
See LOC field in ALL block 
See ALL block 
Assembly, 2-22 
ASYN argument to RABSB macro, 
2-8 
RSTS/E, D-4 
Asynchronous operation 
RAB declaration, 2-8 
See RBSASY mask in ROP field 
waiting for 
See WAIT operation 


BDB pool, 2-8 
BID field in FAB 


INDEX 


offset, 6-22 
summary 
FBSBID code, 6-26 
BID field in RAB 
offset, 6-115 
summary 
RBSBID code, 6-116 
Binary key 
See XBSBN2 mask in DTP field 
See XBSBN4 mask in DTP field 
BKS field in FAB 
CREATE operation, 5-17 
offset, 6-24 
OPEN operation, 5-78 
RSTS/E, D-3 
summary, 6-27 
BKT field in RAB, 4-6, 
4-12 to 4-13 
FIND operation, 5-50, 5-52, 
5-55 
GET operation, 5-61, 5-65, 
5-68 
offset, 6-115 
PUT operation, 5-93, 5-96 
READ operation, 5-98, 5-100 
SPACE operation, 5-120 
summary, 6-117 
WRITE operation, 5-127, 5-129 
BKZ field in ALL block 
CREATE operation, 5-17 
DISPLAY operation, 5-30 
offset, 6-2 
OPEN operation, 5-79 
RSTS/E, D-3 to D-4 
summary, 6-8 
BLN field in ALL block 
offset, 6-2 
summary 
XBSLAL code, 6-9 
BLN field in DAT block 
offset, 6-14 
summary 
XBSDTL code, 6-15 
BLN field in FAB 
offset, 6-22 
summary 
FBSBLN code, 6-28 
BLN field in KEY block 
offset, 6-67 
summary 
XBSKYL code, 6-69 
BLN field in PRO block 
offset, 6-108 
summary 
XBSPRL code, 6-109 
BLN field in RAB 
offset, 6-115 
summary, 6-118 
BLN field in SUM block 
offset, 6-145 
summary 
XBSSML code, 6-146° 
Block 
access mode 
See BKT field in RAB 


Index-2 


INDEX 


locating See UBF field in RAB 
See SPACE operation Buffer pool, 3-5 
reading 
See READ operation Call 
size, magtape operation routine, 2-14 
See BLS field in FAB arguments in memory, 2-15 
writing macro argument, 2-14 
See WRITE operation . Carriage control 
Block context, 4-12 See RAT field in FAB 
Block operation, 4-14 Carriage-control device 
Block operation macro See FBSCCL mask in DEV field 
SREAD, 5-98, 5-100 Carriage-return carriage control 
SSPACE, 5-120 See FBSCR mask in RAT field 
SWRITE, 5-127, 5-129 Casette tape device, 3-2, 5-20, 
declaring, C-3 5-37, 5-43, 5-77, 5-88, 
Block processing, 4-11 5-104, 5-111, 5-118 
Block stream, 4-11 CDT field in DAT block 
Block-declaration macro, 2-8, DISPLAY operation, 5-32 
2-10 offset, 6-14 
Blocked record OPEN operation, 5-81 
See FBSBLK mask in RAT field RSTS/E, D-4 
BLS field in FAB summary, 6-16 
CREATE operation, 5-15 Central buffer pool, 3-5 
offset, 6-24 Changed key 
OPEN operation, 5-79 See XBSCHG mask in FLG field 
summary, 6-29 CLOSE operation, 3-9 
BPA field in FAB, 2-7, 3-5 SCLOSE macro, 5-3 
CLOSE operation, 5-4 BDB requirement, 2-8 
CREATE operation, 5-13 I/O buffer requirement, 2-7 
ENTER operation, 5-36 wildcard loop, 3-11 
ERASE operation, 5-42 Cluster size 
offset, 6-24 See RTV field in FAB 
OPEN operation, 5-74 COD field in ALL block 
PARSE operation, 5-87 offset, 6-2 
REMOVE operation, 5-104 summary 
RENAME operation, 5-110 XBSALL code, 6-10 
SEARCH operation, 5-117 COD field in DAT block 
summary, 6-30 offset, 6-14 
BPS field in FAB, 2-7, 3-5 summary 
CLOSE operation, 5-4 XBSDAT code, 6-17 ™ 
CREATE operation, 5-13 COD field in KEY block 
ENTER operation, 5-36 offset, 6-67 
ERASE operation, 5-42 summary 
offset, 6-24 XBSKEY code, 6-70 
OPEN operation, 5-74 COD field in PRO block 
PARSE operation, 5-87 offset, 6-108 
REMOVE operation, 5-104 summary 
RENAME operation, 5-110 XBSPRO code, 6-110 
SEARCH operation, 5-117 COD field in SUM block 
summary, 6-31 offset, 6-145 
Bucket summary 
fill number XBSSUM code, 6-147 
data Code and mask symbol 
See DFL field in KEY block declaring 
honoring ALL block, C-3 to C+4 
See RBSLOA mask in ROP field DAT block, C-3 to C-4 
index FAB, C-l 
See IFL field in KEY block KEY block, C-3 to C-4 
size NAM block, C-2 
See BKS field in FAB PRO block, C-3 to C-4 
See BKZ field in ALL block RAB, C-2 
Buffer SUM block, C-3 to C-4 
record XAB, C-4 
See RBF field in RAB value 
user ALL block, 6-2 
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DAT block, 6-14 summary, 6-71 
FAB, 6-22 DAT block 
KEY block, 6-67 chaining to FAB, 2-13 to 2-14 
NAM block, 6-94 declaring, 2-8 
PRO block, 6-108 initializing, 2-10 
RAB, 6-115 summary, 6-14 
SUM block, 6-145 Data area number 
Code symbol See DAN field in KEY block 
See Code and mask symbol Date 
Completion See DAT block 
handler, 2-18 XAB 
return macro See DAT block 
declaring, C-2 DBS field in KEY block 
symbol DISPLAY operation, 5-31 
declaring, C-3 offset, 6-68 
Completion status OPEN operation, 5-80 . 
See STS field in FAB summary, 6-72 
See STS field in RAB DECtape device, 3-1, 5-20, 
See STV field in FAB 5-37, 5-42, 5-77, 5-88, 
See STV field in RAB 5-104, 5-111, 5-117 
CONNECT operation DECTAPE II device, 3-1, 5-20, 
SCONNECT macro, 5-6 5-37, 5-42, 5-77, 5-88, 
BDB requirement, 2-8 5-104, 5-111, 5-117 
block stream, 4-13 DEFSSZ argument, C-1 
I/O buffer requirement, 2-7 Default extension size 
IRAB requirement, 2-5 See DEQ field in ALL block 
key buffer requirement, 2-6 See DEQ field in FAB 
record stream, 4-8 Default string 
Context See DNA field in FAB 
block stream, 4-12 Deferred writing 
record stream, 4-3 See FBSDFW mask in FOP field 
Contiguity DEL argument to ORGS macro, 2-3 
See FBSCTG mask in FOP field DELETE operation, 4-11 
See XBSCTG mask in AOP field SDELETE macro, 5-25 
Control block, 1-2 declaring with ORGS macro, 2-3 
chaining, 2-13 Deletion, file marked for 
declaring, 2-8 . See FBSMKD mask in FOP field 
examining, 2-16 DEQ field in ALL block 
field CREATE operation, 5-17 
See Field — DISPLAY operation, 5-30 
initializing, 2-8 offset, 6-2 
setting up, 2-11 OPEN operation, 5-79 
CRE argument to ORGS macro, 2-3 RSTS/E, D-4 
CREATE operation, 3-8 summary, 6-11 
SCREATE macro, 5-9 DEQ field in FAB 
BDB requirement, 2-8 CREATE operation, 5-17 
declaring with ORGS macro, 2-3 offset, 6-22 
I/O buffer requirement, 2-7 OPEN operation, 5-74, 5-78 
IFAB requirement, 2-5 summary, 6-33 
wildcard loop, 3-11 DEV field in FAB, 3-1 to 3-2 
Creation date CREATE operation, 5-20 
See CDT field in DAT block ENTER operation, 5-37 
CTX field in FAB, 2-20 ERASE operation, 5-42 to 5-43 
offset, 6-22 offset, 6-24 ; 
summary, 6-32 OPEN operation, 5-77 
CTX field in RAB, 2-20 PARSE operation, 5-88 
offset, 6-115 REMOVE operation, 5-104 
summary, 6-119 RENAME operation, 5-111 
Current-record context, 4-3 SEARCH operation, 
5-117 to 5-118 
DAN field in KEY block summary, 6-34 
CREATE operation, 5-19 Device 
DISPLAY operation, 5-31 characteristics 
offset, 6-67 See DEV field in FAB 
OPEN operation, 5-80 identifier 
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See DVI field in NAM block 5-109 to 5-110 
DFINSG argument, C-1l summary, 6-35 
DFINSL argument, C-1 DNS field in FAB,. 3-3 
DFL field in KEY block CREATE operation, 5-10 
CREATE operation, 5-20 ENTER operation, 5-36 
DISPLAY operation, 5-31 ERASE operation, 5-41 
offset, 6-67 - +4 offset, 6-24 
OPEN operation, 5-80 OPEN operation, 5-73 
summary, 6-73 PARSE operation, 5-87 
DID field in NAM block REMOVE operation, 5-103 
CREATE operation, 5-10, 5-21 RENAME operation, 
ENTER operation, 5-36 to 5-37 5-109 to 5-110 
ERASE operation, 5-41 to 5-42 summary, 6-36 
offset, 6-94 DTP field in KEY block 
OPEN operation, 5-73, 5-77 CREATE operation, 5-18 
PARSE operation, 5-87 DISPLAY operation, 5-31 
REMOVE operation, 5-103, 5-105 offset, 6-67 
RENAME operation, OPEN operation, 5-80 
5-109 to 5-111 summary, 6-74 
SEARCH operation, 5-116, 5-118 Duplicate key 
summary, 6-95 See XBSDUP mask in FLG field 
DID field in NAM block field DVB field in KEY block 
RSTS/E, D-4 DISPLAY operation, 5-31 
Directory offset, 6-68 
wildcard context OPEN operation, 5-80 
See WDI field in NAM block summary, 6-75 
wildcard operation DVI field in NAM block, 3-3 
See NBSWCH mask in FNB field CREATE operation, 5-10, 5-21 
Directory entry ENTER operation, 5-36 to 5-37 
creating ERASE operation, 5-41 to 5-42 
See ENTER operation offset, 6-94 
deleting OPEN operation, 5-73, 5-77 
See REMOVE operation PARSE operation, 5-88 
replacing REMOVE operation, 5-103, 5-105 
See RENAME operation RENAME operation, 
Directory operation, 3-5 5-109 to 5-111 
Directory operation macro SEARCH operation, 5-116 
SENTER, 5-35 summary, 6-96 
SPARSE, 5-86 
SREMOVE, 5-102 EDT field in DAT block 
SRENAME, 5-108 DISPLAY operation, 5-32 
SSEARCH, 5-116 offset, 6-14 
declaring, C-2 OPEN operation, 5-81 
Directory processing, 3-1 summary, 6-18 
DISCONNECT operation EDT field in NAM block 
SDISCONNECT macro, 5-27 RSX-1l, D-4 
block stream, 4-14 ENTER operation, 3-6 
record stream, 4-9 SENTER macro, 5-35 
Disk device, 3-1, 5-20, 5-37, BDB requirement, 2-8 
5-42, 5-77, 5-88, 5-104, I/O buffer requirement, 2-7 
5-111, 5-117 IFAB requirement, 2-5 
DISPLAY operation, 3-8 wildcard loop, 3-11 
SDISPLAY macro, 5-29 ERS-family symbol 
BDB requirement, 2-8 declaring, C-3 
I/O buffer requirement, 2-7 © value, A-1 to A-19 
wildcard loop, 3-11 ERASE operation, 3-8 
DNA field in FAB, 3-3 SERASE macro, 5-40 
CREATE operation, 5-10 BDB requirement, 2-8 
ENTER operation, 5-36 I/O buffer requirement, 2-7 
ERASE operation, 5-41 IFAB requirement, 2-5 
offset, 6-24 wildcard loop, 3-10 to 3-11 
OPEN operation, 5-73 nonselective, 3-11 
PARSE operation, 5-87 selective, 3-12 
REMOVE operation, 5-103 Error 
RENAME operation, assembly-time, 2-22 
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fatal, 2-16 
handler, 2-18 

ESA field in NAM block, 3-3, 
3-10 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-42 
offset, 6-94 
OPEN operation, 5-74 
PARSE operation, 5-87 
REMOVE operation, 5-104 
RENAME operation, 5-110 
SEARCH operation, 5-116 
summary, 6-97 

ESL field in NAM block 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-42 
offset, 6-94 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
SEARCH operation, 5-116 
summary, 6-98 

ESS field in NAM block 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-42 
offset, 6-94 
OPEN operation, 5-74 
PARSE operation, 5-87 
REMOVE operation, 5-104 
RENAME operation, 5-110 
summary, 6-99 

Expanded string 
See ESA field in NAM block 

EXTEND operation, 3-9 
SEXTEND macro, 5-46 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
wildcard loop, 3-11 

Extended attribute block 
See XAB 


FS-family macro, 2-10 
declaring, C-1l 
example, 7-3, 7-7, 7-11, 7-15 
FAB 
chaining to RAB, 2-14 
declaring, 2-8 
initializing, 2-10 
summary, 6-22 
FAB field in RAB, 4-2 
chaining FAB to RAB, 2-14 
CONNECT operation, 5-6 
offset, 6-115 
summary, 6-120 
FABSB macro, 2-8, C-l 
example, 7-3, 7-7, 7-11, 7-15 
FABSBT macro, C-l 
FABSE macro, 2-10 
declaring, C-l 
example, 7-3, 7-7, 7-ll, 7-15 
FABOFS macro, C-1 
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FAC field in FAB 
CREATE operation, 5-14 
offset, 6-22 
OPEN operation, 5-75 
summary, 6-37 

Facilities-declaration macro, 
2-20 
declaring, C-2 

Fast deletion 
See RBSFDL mask in ROP field 

Fatal error, 2-16 

FBS-family symbol 
declaring, C-1l 

FBSBID code in BID field 
summary, 6-26 
value, 6-22 

FBSBLK mask in RAT field 
CREATE operation, 5-11 
OPEN operation, 5-78 
summary, 6-60 
value, 6-23 

FBSBLN code in BLN field 
summary, 6-28 
value, 6-22 

FBSCCL mask in DEV field, 3-1 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-42 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-117 
value, 6-24 

FBSCR mask in RAT field 
CREATE operation, 5-12 
OPEN operation, 5-78 
value, 6-23 

FBSCTG mask in FOP field 
CREATE operation, 5-18 
EXTEND operation, 5-46 
OPEN operation, 5-78 
RSTS/E, D-4 
summary, 6-40 
value, 6-23 

FBSDEL mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSDFW mask in FOP field 
CREATE operation, 5-15 
OPEN operation, 5-76 
summary, 6-41 
value, 6-23 

FBSDLK mask in FOP field 
CREATE operation, 5-15 
OPEN operation, 5-76 
summary, 6-42 
value, 6-23 

FBSFID mask in FOP field, 3-8, 
3-10 to 3-12 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-41 
OPEN operation, 5-73 to 5-74 
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REMOVE operation, 
RENAME operation, 
5-109 to 5-110 

summary, 6-43 
value, 6-23 

FBSFIX code in RFM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSFTN mask in RAT field 
CREATE operation, 5-12 
OPEN operation, 5-78 
value, 6-23 

FBSGET mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSGET mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSIDX code in ORG field 
CREATE operation, 5-11. 
OPEN operation, 5-78 
value, 6-23 

FBSMDI mask in DEV field, 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-42 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-117 
value, 6-24 

FBSMKD mask in FOP field 
CREATE operation, 5-11 
summary, 6-44 
value, 6-23 

FBSNEF mask in FOP field 
OPEN operation, 5-76 
RSTS/E, D-4 
summary, 6-45 
value, 6-23 

FBSNIL mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSPOS mask in FOP field 
CREATE operation, 5-15 
summary, 6-46 
value, 6-23 

FBSPRN mask in RAT field 
CREATE operation, 5-12 
OPEN operation, 5-78 
value, 6-23 

FBSPUT mask in FAC field 

- CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSREA mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSREC mask in DEV field, 


5-103 


3-1 
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3-1 to 3-2 
CREATE operation, 5-20 
ENTER operation, 5-37 


ERASE operation, 5-42 to 5-43 


5-77 

5-88 
5-104 
5-111 


OPEN operation, 
PARSE operation, 
REMOVE operation, 
RENAME operation, 
SEARCH operation, 
5-117 to 5-118 

value, 6-24 

FBSREL code in ORG field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSRWC mask in FOP field 
CLOSE operation, 5-4 
CREATE operation, 5-15 
OPEN operation, 5-77 
SEARCH operation, 5-117 
summary, 6-47 
value, 6-23 

FBSRWO mask in FOP field 
CREATE operation, 5-15 
OPEN operation, 5-76 
SEARCH. operation, 5-117 
summary, 6-48 
value, 6-23 

FBSSDI mask in DEV field, 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-118 
value, 6-24 

FBSSEQ code in ORG field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 ; 

FBSSQD mask in DEV field, 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-118 
value, 6-24 ; 

FBSSTM code in RFM fiel 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSSUP mask in FOP field 
CREATE operation, 5-10 
summary, 6-49 
value, 6-23 

FBSTMD mask in FOP field 
CREATE operation, 5-11 
value, 6-23 

FBSTMP mask in FOP field 
CREATE operation, 5-11 
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summary, 6-50 
value, 6-23 | 

FBSTRM mask in DEV field, 3-1 
CREATE operation, 5-20 
ENTER operation, 5-37 
ERASE operation, 5-42 
OPEN operation, 5-77 
PARSE operation, 5-88 
REMOVE operation, 5-104 
RENAME operation, 5-111 
SEARCH operation, 5-117 
value, 6-24 

FBSTRN mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSUDF code in REM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSUPD mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSUPI mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 


FBSUPI mask in SHR field of FAB 


RSX-ll, D-4 

FBSVAR code in REM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSVFC code in RFM field 
CREATE operation, 5-11 
OPEN operation, 5-78 
value, 6-23 

FBSWRI mask in SHR field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FBSWRT mask in FAC field 
CREATE operation, 5-14 
OPEN operation, 5-75 
value, 6-22 

FID field in NAM block 
CREATE operation, 5-21 
ENTER operation, 5-36 


ERASE operation, 5-41 to 5-42 


offset, 6-94 
OPEN operation, 5-73, 5-77 
REMOVE operation, 5-105 
RENAME operation, 5-111 
SEARCH operation, 5-118 
summary, 6-100 

Field, 1-2 
clearing bits in, 2-12 
comparing value, 2-17 
copying value from, 2-16 
copying value into, 2-11 
examining, 2-16 
initializing, 2-8 
mnemonic, 1-2 
setting bits in, 2-12 
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setting up, 2-11 
testing bits in, 
Field-access macro 
SCOMPARE, 2-17 
SFETCH, 2-16 
SOFF, 2-12 
SSET, 2-12 
SSTORE, 2-11 
STESTBITS, 2-18 
declaring, C-2 
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Field-initialization macro, 2-10 


declaring 
ALL block, C-3 
DAT block, C- 
FAB, C-1 
KEY block, C-3 
NAM block, C-2 
C-3 
c- 
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PRO block, 
RAB, C-2 
SUM block, 
Field-offset symb 
declaring 
ALL block, C-3 
DAT block, C-3 
FAB, C-1 
KEY block, C- 
NAM block, C- 
PRO block, C- 
c- 


3 
° 


RAB, C-2 

SUM block, 

XAB, C-4 
value 

ALL block, 6-2 

DAT block, 6-1 

FAB, 6-22 

KEY block, 6-6 

NAM block, 6-9 

PRO block, 6-1 

RAB, 6-115 

SUM block, 6-1 

File 

access requested 

See FAC field 
access shared 

See SHR field 
alignment 

See ALN field 
allocation 

See ALQ field 

See ALQ field 
area 

See ALL block 
bucket size 

See BKS field 

See BKZ field 
closing 


1 


to 
to 


to 
to 


to 
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4 
08 
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in 
in 
in 


in 
in 


in 
in 


FAB 
FAB 
ALL block 


ALL block 
FAB 


FAB 
ALL block 


See CLOSE operation 


cluster size 


See RTV field in FAB 


contiguity 


See FBSCTG mask in FOP field 
See XBSCTG mask in AOP field 


creating 


See CREATE operation 


creation date 
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See CDT field in DAT block 
date 

See DAT block 
default extension size 

See DEQ field in ALL block 

See DEQ field in FAB 
deleting 

See ERASE operation 
extending allocation 

See EXTEND operation 
identifier 

See FID field in NAM block 
internal file identifier 

See IFI field in FAB 
location 

See LOC field in ALL block 
locking 

See FBSDLK mask in FOP field 
name block 

See NAM block 


opening 

See OPEN operation 
organization 

See ORG field in FAB 
owner 

See PRG field in PRO block 
protection 


See PRO field in PRO block 
record-output characteristic 
See RAT field in FAB 
renaming 
See RENAME operation 
revision date 
See RDT field in DAT block 
revision number 
See RVN field in DAT block 
specification string 
default 
See DNA field in FAB 
parsing 
See FNB field in NAM block 
See FNA field in FAB 


string 

See FNA field in FAB 
supersession 

See FBSSUP mask in FOP field 
truncating 


See TRUNCATE operation 
wildcard context 
See WCC field in NAM block 
wildcard operation 
See NBSWCH mask in FNB field 
wildcard search 
See SEARCH operation 
File access block 
See FAB 
File operation, 3-7 
File operation macro 
SCLOSE, 5-3 
SCREATE, 5-9 
SDISPLAY, 5-29 
SERASE, 5-40 
SEXTEND, 5-46 
SOPEN, 5-72 
declaring, C-2 
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File processing, 3-1 
File specification 
fully qualified, 3-4 
merged string, 3-3 
parsing 
See PARSE operation 
wildcard, 3-9 
Fill number 
data bucket 
See DFL field in KEY block 
index bucket 
See IFL field in KEY block 
FIN argument to ORGS macro, 2-3 
FIND operation, 4-10 
SFIND macro 
key access, 5-51 
RFA access, 5-54 
sequential access, 5-49 
declaring with ORGS macro, 2-3 
Fixed-control-size 
See FSZ field in FAB 
Fixed-length record format 
See FBSFIX code in RFM field 
FLG field in KEY block 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary 
XBSCHG mask, 6-76 
XBSDUP mask, 6-77 
XBSNUL mask, 6-78 
FLUSH operation 
SFLUSH macro, 5-56 
record stream, 4-8 
FNA field in FAB, 3-3 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-41 
offset, 6-24 
OPEN operation, 5-73 
PARSE operation, 5-87 
REMOVE operation, 5-103 
RENAME operation, 
5-109 to 5-110 
summary, 6-38 
FNB field in NAM block, 3-3, 
3-10 to 3-11 
CREATE operation, 5-21 
ENTER operation, 5-37 to 5-38 
ERASE operation, 5-41, 5-43 
offset, 6-94 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-103, 5-105 
RENAME operation, 5-109, 
5-111 to 5-112 
SEARCH operation, 5-116, 5-118 
summary, 6-101 
NBSWCH mask, 6-102 
wildcard loop, 3-11 
FNS field in FAB, 3-3 
CREATE operation, 5-10 
ENTER operation, 5-36 
ERASE operation, 5-41 
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offset, 6-24 

OPEN operation, 5-73 
PARSE operation, 5-87 
REMOVE operation, 5-103 
RENAME operation, 

5-109 to 5-110 

summary, 6-39 

FOP field in FAB, 3-8, 
3-10 to 3-12 
CLOSE operation, 5-4 
CREATE operation, 

5-10 to 5-11, 5-15, 5-18 
ENTER operation, 5-36 
ERASE operation, 5-41 
EXTEND operation, 5-46 
offset, 6-23 
OPEN operation, 5-73 to 5- 

5-76 to 5-78 . 
REMOVE operation, 5-103 
RENAME operation, 

5-109 to 5-110 
SEARCH operation, 5-117 
summary 

FBSCTG mask, 6-40 

FBSDEW mask, 6-41 

FBSDLK mask, 6-42 

FBSFID mask, 6-43 

FBSMKD mask, 6-44 

FBSNEF mask, 6-45 

FBSPOS mask, 6-46 

FBSRWC mask, 6-47 

FBSRWO mask, 6-48 

FBSSUP mask, 6-~-49 

FBSTMP mask, 6-50 
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I/O buffer pool, 2-6 

IAN field in KEY block 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-79 

IBS field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
summary, 6-80 

IDB pool, 2-5 

IDX argument to ORGS macro, 2-3 

IFAB pool, 2-5 

IFI field in FAB 

74, CLOSE operation, 5-3 to 5-4 

CONNECT operation, 5-6 
CREATE operation, 5-20 
DISPLAY operation, 5-30 
EXTEND operation, 5-46 
offset, 6-22 
OPEN operation, 5-77 
summary, 6-52 

IFL field in KEY block 
CREATE operation, 5-20 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-81 

Index 
area bucket size 

See IBS field in KEY block 

area number 


FORTRAN-style carriage control higher levels 


See FBSFTN mask in RAT fie 
FREE operation 

SFREE macro, 5-58 

block stream, 4-13 

record stream, 4-9 


Free-space list for pool, 2- 


FSZ field in FAB 
CREATE operation, 5-11 
offset, 6-24 
OPEN operation, 5-78 
summary, 6-51 


GET argument to ORGS macro, 
GET operation, 4-10 
SGET macro 
key access, 5-63 
RFA access, 5-67 
sequential access, 5-60 
declaring with ORGS macro, 
Get-space routine, 2-20 
example, 7-18 
macro 
declaring, C-2 
RMS-1ll-supplied, 2-4 
GSAS macro, 2-20 
example, 7-3, 7-7, 7-1l, 7 


Hard location 
See XBSHRD mask in AOP fie 


ld See IAN field in KEY block 
lowest level 
See LAN field in KEY block 
count 
See NOK field in SUM block 
21 data bucket size 
See DBS field in KEY block 
data bucket VBN 
See DVB field in KEY block 
description, obtaining 
See DISPLAY operation 
level count 
2-3 See LVL field in KEY block 
reference number 
See REF field in KEY block 
root bucket VBN : 
See RVB field in KEY block 
See KEY block 
2-3 Indexed file 
declaring with ORGS macro, 2-3 
Indexed file organization 
See FBSIDX code 
Initialization 
field, 2-10 
Integer key 


-15 See XBSIN2 mask in DTP field 


See XBSIN4 mask in DTP field 
Internal file identifier 
1d See IFI field in FAB 
Internal stream identifier 
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See ISI field in RAB 

IRAB pool, 2-5 

ISI field in RAB, 4-2 
CONNECT operation, 5-7 
DELETE operation, 5-25 
DISCONNECT operation, 5-27 
FIND operation, 5-49, 5-51, 

5-54 
FLUSH operation, 5-56 
FREE operation, 5-58 
GET operation, 5-60, 5-63, 
5-67 

NXTVOL operation, 5-70 
offset, 6-115 
PUT operation, 5-91, 5-95 
READ operation, 5-98, 5-100 
REWIND operation, 5-114 
SPACE operation, 5-120 
summary, 6-121 
TRUNCATE operation, 5-122 
UPDATE operation, 5-124 
WAIT operation, 5-126 
WRITE operation, 5-127, 5-129 


KBF field in RAB, 4-5 
FIND operation, 5-52 
GET operation, 5-63 
offset, 6-115 
PUT operation, 5-96 
summary, 6-122 

Key 
buffer address 

See KBF field in RAB 
buffer size 
See KSZ field in RAB 


changes 

See XBSCHG mask in FLG field 
characteristics 

See FLG field in KEY block 
data type 


See DTP field in KEY block 
duplication 


See XBSDUP mask in FLG field 


match criterion 


See RBSKGE mask in ROP field 
See RBSKGT mask in ROP field 


name 

See KNM field in KEY block 
null character 

See NUL field in KEY block 
reference 

See KRF field in RAB 
segment 

position 


See POS field. in KEY block 


size 


See SIZ field in KEY block 


segment count 
See NSG field in KEY block 
size, total 
See TKS field in KEY block 
XAB 
See KEY block 
KEY block 
chaining to FAB, 2-13 to 2-14 
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declaring, 2-8 
initializing, 2-10 
summary, 6-67 


Key buffer pool, 2-6 
Key record access 


See RBSKEY code in RAC field 


KNM field in KEY block 


CREATE operation, 5-18 
DISPLAY operation, 5-30 
offset, 6-68 

OPEN operation, 5-74 
summary, 6-82 


KRF field in RAB, 4-5 


CONNECT operation, 5-7 
FIND operation, 5-51 
GET operation, 5-63 
offset, 6-115 

REWIND operation, 5-114 
summary, 6-123 


KSZ field in RAB, 4-5 to 4-6 


FIND operation, 5-52 
GET operation, 5-63 

offset, 6-115 

PUT operation, 5-96 

summary, 6-124 


LAN field in KEY block 


CREATE operation, 5-19 
DISPLAY operation, 5-31 
offset, 6-67 

OPEN operation, 5-80 
summary, 6-83 


LCH field in FAB, 3-2 


CREATE operation, 5-13 
ENTER operation, 5-36 
ERASE operation, 5-42 
offset, 6-24 

OPEN operation, 5-74 
PARSE operation, 5-87 
REMOVE operation, 5-104 
RENAME operation, 5-110 
SEARCH operation, 5-117 
summary, 6-53 


Loc field in ALL block 


CREATE operation, 5-17 
EXTEND operation, 5-47 
offset, 6-2 

RSTS/E, D-4 

summary, 6-12 


LOCO field in ALL block 


offset, 6-2 


LOC] field in ALL block 


offset, 6-2 


Locate mode 


See RBSLOC mask in ROP field 


Location 


hard 
See XBSHRD mask in AOP field 
See LOC field in ALL block 


Locking, file 


See FBSDLK mask in FOP field 


Logical channel number 


See LCH field in FAB 


LRL field in FAB 


CREATE operation, 5-20 


Index-11 


INDEX 


offset, 6-24 Summary, 6-56 
OPEN operation, 5-79 Multiblock count 
summary, 6-54 See MBC field in RAB 
LVL field in KEY block Multibuffer count 
DISPLAY operation, 5-32 See MBF field in RAB 
offset, 6-67 Multidirectory device 
OPEN operation, 5-80 See FBSMDI mask in DEV field 


summary, 6-84 
NS-family macro, 2-10 


Macro library declaring, C-2 
RMSMAC.MLB, 2-22 example, 7-3, 7-7, 7-11, 7-15 
RSTS/E, D~3 NAM block 
Macro-declaration macro, 2-2 chaining to FAB, 2-13 
Magtape declaring, 2-8 
positioning identification by 
See FBSNEF mask in FOP field See FBSFID mask in FOP field 
See FBSPOS mask in FOP field initializing, 2-10 
See RBSEOF mask in ROP field summary, 6-94 
rewind-after-closing NAM field in FAB 
See FBSRWC mask in FOP field chaining NAM block to FAB, 
rewind-before-creating 2-13 
See FBSRWO mask in FOP field CREATE operation, 5-9 
rewind-before-opening ENTER operation, 5-35 
See FBSRWO mask in FOP field ERASE operation, 5-40 
Magtape block size offset, 6-24 
See BLS field in FAB OPEN operation, 5-72 
Magtape device, 3-2, 5-20, PARSE operation, 5-86 
5-37, 5-43, 5-77, 5-88, REMOVE operation, 5-102 
5-104, 5-111, 5-118 RENAME operation, 5-108 
ANSI, 3-2, 5-20, 5-37, 5-43, SEARCH operation, 5-116 
5-77, 5-88, 5-104, 5-111, summary, 6-57 
5-118 NAMSB macro, 2-8, C-2 
P/OS, D-3 example, 7-3, 7-7, 7-11, 7-15 
Mark-for-deletion NAMSE macro, 2-10 
See FBSMKD mask in FOP field declaring, C-2 
Mask symbol example, 7-3, 7-7, 7-11, 7-15 
See Code and mask symbol NAMOFS macro, C-2 
Mass insertion NBS-family symbol 
See RBSMAS mask in ROP field declaring, C-2 
Match criterion NBSDEV mask in FNB field 
See RBSKGE mask in ROP field CREATE operation, 5-21 
See RBSKGT mask in ROP: field _ ENTER operation, 5-37 
MBC field in RAB ERASE operation, 5-43 
CONNECT operation, 5-6 OPEN operation, 5-81 
offset, 6-115 PARSE operation, 5-88 
summary, 6-125 REMOVE operation, 5-105 
MBF field in RAB RENAME operation, 5-111 
CONNECT operation, 5-6 value, 6-94 
offset, 6-115 NBSDIR mask: in FNB field 
summary, 6-126 CREATE operation, 5-21 
Merged string, 3-3 ENTER operation, 5-37 
MRL field in KEY block ERASE operation, 5-43 
DISPLAY operation, 5-32 OPEN operation, 5-81 
offset, 6-68 PARSE operation, 5-88 
OPEN operation, 5-80 REMOVE operation, 5-105 
summary, 6-85 : RENAME operation, 5-111 
MRN field in FAB value, 6-94 
CREATE operation, 5-13 NBSNAM mask in FNB field 
offset, 6-24 CREATE operation, 5-21 
OPEN operation, 5-79 ENTER operation, 5-37. 
summary, 6-55 ERASE operation, 5-43 
MRS field in FAB . OPEN operation, 5-81 
CREATE operation, 5-12 PARSE operation 
offset, 6-24 (set if NBSQUO is set), 5-88 
OPEN operation, 5-79 REMOVE operation, 5-105 
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RENAME operation, 5-111 
value, 6-94 


NBSNOD mask in FNB field 


CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 


NBSQUO mask in FNB field 


CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 


NBSTYP mask in FNB field 


CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation 
(set if NBSQUO is set), 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 


NBSVER mask in FNB field 


CREATE operation, 5-21 
ENTER operation, 5-37 

ERASE operation, 5-43 

OPEN operation, 5-81 

PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 . 


NBSVER mask in FNB field of NAM 


RSX-11, D-3 to D-4 


NBSWCH mask in FNB field, 


3-10 to 3-11 

CREATE operation, 5-21 

ENTER operation, 5-38 

ERASE operation, 5-41, 5-43 
OPEN operation, 5-81 

PARSE operation, 5-88 

REMOVE operation, 5-103, 5-105 
RENAME operation, 5-109, 5-112 
SEARCH operation, 5-116, 5-118 
summary, 6-102 
value, 6-94 

wildcard loop, 3-11 


NBSWDI mask in FNB field 


CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 


NBSWNA mask in FNB field 


CREATE operation, 5-21 
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ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 

NBSWTY mask in FNB field 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 

NBSWVE mask in FNB field 
CREATE operation, 5-21 
ENTER operation, 5-37 
ERASE operation, 5-43 
OPEN operation, 5-81 
PARSE operation, 5-88 
REMOVE operation, 5-105 
RENAME operation, 5-111 
value, 6-94 

Next-record context, 4-3 

NOA field in SUM block 
DISPLAY operation, 5-32 
offset, 6-145 
OPEN operation, 5-81 
summary, 6-148 

NOK field in SUM block 
DISPLAY operation, 5-32 
offset, 6-145 
OPEN operation, 5-81 
summary, 6-149 

NSG field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-81. 
summary, 6-86 

NUL field in KEY block 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
offset, 6-67 
OPEN operation, 5-80 
summary, 6-87 

Null key character 
See NUL field in KEY block 
See XBSNUL mask in FLG field 

NXT field in ALL block 
CLOSE operation, 5-3 
CREATE operation, 5-9 
DISPLAY operation, 5-30 
ENTER operation, 5-35 
ERASE operation, 5-40 
EXTEND operation, 5-46 
offset, 6-2 : 
OPEN operation, 5-73 
PARSE operation, 5-86 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-13 

NXT field in DAT block 
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CLOSE operation, 5-3 FAB field offset, C-1 
CREATE operation, 5-9 KEY block, C-3 to C-4 
DISPLAY operation, 5-30 NAM block field offset, C-2 
ENTER operation, 5-35 PRO block, C-3 to C4 
ERASE operation, 5-40 RAB, C-2 
EXTEND operation, 5-46 SUM block, C-3 to C-4 
offset, 6-14 XAB, C-4 
OPEN operation, 5-73 value 
PARSE operation, 5-86 ALL block, 6-2 
REMOVE operation, 5-102 DAT block, 6-14 
RENAME operation, 5-108 FAB, 6-22 to 6-24 : 
SEARCH operation, 5-116 KEY block, 6-67 to 6-68 
summary, 6-19 NAM block, 6-94 
NXT field in KEY block PRO block, 6-108 
CLOSE operation, 5-3 RAB, 6-115 
CREATE operation, 5-9 SUM block, 6-145 
DISPLAY operation, 5-30 OPEN operation, 3-8 
ENTER operation, 5-35 SOPEN macro, 5-72 
ERASE operation, 5-40 BDB requirement, 2-8 
EXTEND operation, 5-46 I/O buffer requirement, 2-7 
offset, 6-67 IFAB requirement, 2-5 
OPEN operation, 5-73 wildcard loop, 3-11 to 3-12 
PARSE operation, 5-86 Operation, 1-2 
REMOVE operation, 5-102 routine 
RENAME operation, 5-108 calling, 2-14 
SEARCH operation, 5-116 return, 2-15 
summary, 6-88 using, 2-10 
NXT field in PRO block Operation macro, 1-2, 2-10 
CLOSE operation, 5-3 ORG field in FAB 
CREATE operation, 5-9 CREATE operation, 5-11 
DISPLAY operation, 5-30 offset, 6-23 
ENTER operation, 5-35 OPEN operation, 5-78 
ERASE operation, 5-40 summary, 6-58 
EXTEND operation, 5-46 ORGS macro, 2-2 
offset, 6-108 Organization, file 
OPEN operation, 5-73 See ORG field in FAB 
PARSE operation, 5-86 Owner, file 
REMOVE operation, 5-102 See PRG field in PRO block 
RENAME operation, 5-108 
SEARCH operation, 5-116 P$-family macro 
summary, 6-111 declaring, C-2 
NXT field in SUM block PSBDB macro 
CLOSE operation, 5-3 argument computation, 2-8 
CREATE operation, 5-9 format, 2-4 
DISPLAY operation, 5-30 PSBUF macro 
ENTER operation, 5-35 argument computation, 2-7 
ERASE operation, 5-40 format, 2-4 
EXTEND operation, 5-46 PSFAB macro 
offset, 6-145 argument computation, 2-5 
OPEN operation, 5-73 format, 2-4 
PARSE operation, 5-86 PSIDX macro 
REMOVE operation, 5-102 argument computation, 2-5 
RENAME operation, 5-108 format, 2-4 
SEARCH operation, 5-116 PSRAB macro 
summary, 6-150 argument computation, 2-5 
NXT field in XAB format, 2-4 
chaining XABs to FAB, 2-13 - PSRABX macro 
NXTVOL operation argument computation, 
SNXTVOL macro, 5-70 2-5 to 2-6 
record stream, 4-9 format, 2-4 
Packed decimal key 
OS-family symbol See XBSPAC mask in DTP field 
declaring PARSE operation, 3-6 
ALL block, C-3 to C-4 SPARSE macro, 5-86 
DAT block, C-3 to C-4 BDB requirement, 2-8 
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I/O buffer requirement, 2-7 chaining to FAB, 2-13 to 2-14 
IFAB requirement, 2-5 declaring, 2-9 
wildcard initialization, 3-10 initializing, 2-10 
Pool summary, 6-108 
buffer descriptor block, 2-8 PRO field in PRO block 
declaring space, 2-4 CLOSE operation, 5-3 
free-space list, 2-21 CREATE operation, 5-11 
I/O buffer, 2-6 DISPLAY operation, 5-32 
index descriptor block, 2-5 offset, 6-108 
internal FAB, 2-5 OPEN operation, 5-81 
internal RAB, 2-5 : RSTS/E, D-4 
key buffer, 2-6 summary, 6-114 
See also Get-space routine PRO/RMS-11 
POOLSB macro, 2-4, C-2 contrasted with RSTS/E RMS-11, 
POOLSE macro, 2-4 D-1 
declaring, C-2 _ contrasted with RSX-11 RMS-11, 
Pool-declaration macro, 2-4 D-3 
declaring, C-2 Prologue version number 
POS field in KEY block See PVN field in SUM block 
CREATE operation, 5-18 Protection 
DISPLAY operation, 5-31 file 
offset, 6-68 See PRO field in PRO block 
OPEN operation, 5-80 XAB 
summary, 6-89 See PRO block 
POSO field in KEY block PUT argument to ORGS macro, 2-3 
offset, 6-68 PUT operation, 4-10 
POS1 field in KEY block SPUT macro 
offset, 6-68 key access, 5-95 
POS2 field in KEY block sequential access, 5-91 
offset, 6-68 declaring with ORGS macro, 2-3 
POS3 field in KEY block PVN field in SUM block 
offset, 6-68 DISPLAY operation, 5-32 
POS4 field in KEY block offset, 6-145 
offset, 6-68 OPEN operation, 5-81 
POS5 field in KEY block summary, 6-151 
offset, 6-68 
POS6 field in KEY block RS-family macro, 2-10 
offset, 6-68 declaring, C-2 
POS7 field in KEY block RAB 
offset, 6-68 declaring, 2-8 
Positioning initializing, 2-10 
magtape summary, 6-115 


See FBSNEF mask in FOP field RABSB macro, 2-8, C-2 
See FBSPOS mask in FOP field RABSBT macro, C-2 


PRG field in PRO block RABSE macro, 2-10 

CLOSE operation, 5-3 declaring, C-2 

DISPLAY operation, 5-32 RABOFS macro, C-2 

offset, 6-108 RAC field in RAB, 4-4 to 4-6 

OPEN operation, 5-81 FIND operation, 5-49, 5-51, 

RSTS/E, D-4 5-54 

summary, 6-112 GET operation, 5-60, 5-63, 
Printer device, 3-1, 5-20, 5-67 

5-37, 5-42, 5-77, 5-88, offset, 6-115 

5-104, 5-111, 5-117 PUT operation, 5-91, 5-95 
Private buffer pool summary, 6-127 

See BPA field in FAB RAT field in FAB 

See BPS field in FAB CREATE operation, 5-11 to 5-12 
PRJ field in PRO block offset, 6-23 

CLOSE operation, 5-3 OPEN operation, 5-78 

DISPLAY operation, 5-32 summary, 6-59 

offset, 6-108 FBSBLK mask, 6-60 

OPEN operation, 5-81 RBS-family symbol 

RSTS/E, D-4 declaring, C-2 

summary, 6-113 : RBSASY mask in ROP field, 4-1 
PRO block CONNECT operation, 5-7 
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DELETE operation, 5-25 
DISCONNECT operation, 5-27 
FIND operation, 5-49, 5-51, 
5-54 
FLUSH operation, 5-56 
FREE operation, 5-58 
GET operation, 5-60, 5-63, 
5-67 
NXTVOL operation, 5-70 
PUT operation, 5-91, 5-95 
READ operation, 5-98, 5-100 
REWIND operation, 5-114 
RSTS/E, D-4 
SPACE operation, 5-120 
summary, 6-131 
TRUNCATE operation, 5-122 
UPDATE operation, 5-124 
value, 6-115 
WRITE operation, 5-127, 5-129 
RBSBID code in BID field 
summary, 6-116 
value, 6-115 
RBSBLL code in BLN field 
RSTS/E, D-4 
value, 6-115 
RBSBLN code in BLN field 
value, 6-115 
RBSEOF mask in ROP field 
CONNECT operation, 5-7 
summary, 6-132 
value, 6-115 
RBSFDL mask in ROP field 
DELETE operation, 5-25 
summary, 6-133 
value, 6-115 
RBSKEY code in RAC field, 4-5 
FIND operation, 5-51 
GET operation, 5-63 
PUT operation, 5-95 
value, 6-115 
RBSKGE mask in ROP field, 
4-5 to 4-6 
FIND operation, 5-52 
GET operation, 5-64 
summary, 6-134 
value, 6-115 
RBSKGT mask in ROP field, 
4-5 to 4-6 
FIND operation, 5-52 
GET operation, 5-64 
summary, 6-135 
value, 6-115 
RBSLOA mask in ROP field 
PUT operation, 5-92, 5-96 
summary, 6-136 
UPDATE operation, 5-124 
value, 6-115 
RBSLOC mask in ROP field, 4-7 
CONNECT operation, 5-6 
GET operation, 5-61, 5-64, 
5-68 
PUT operation, 5-92 
summary, 6-137 
value, 6-115 
RBSMAS mask in ROP field 
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PUT operation, 5-92 
summary, 6-138 
value, 6-115 
RBSRFA code in RAC field, 4-6 
FIND operation, 5-54 
GET operation, 5-67 
value, 6-115 ; 
RBSSEQ code in RAC field, 4-4 
FIND operation, 5-49 
GET operation, 5-60 
PUT operation, 5-91 
value, 6-115 
RBSUIF mask in ROP field, 4-4 
PUT operation, 5-92, 5-96 
summary, 6-139 
value, 6-115 
RBF field in RAB, 4-7, 4-13 
CONNECT operation, 5-7 
GET operation, 5-61, 5-65, 
5-68 
offset, 6-115 
PUT operation, 5-92 to 5-93, 
5-95 
READ operation, 5-99, 5-101 
summary, 6-128 
UPDATE operation, 5-124 
WRITE operation, 5-127, 5-129 
RDT field in DAT block 
DISPLAY operation, 5-32 
offset, 6-14 
OPEN operation, 5-81 
RSTS/E, D-4 
summary, 6-20 
READ operation, 4-14 
SREAD macro 
sequential access, 5-98 
VBN access, 5-100 
Readable-block context, 4-12 
Record 
access mode 
See RAC field in RAB 
blocked 
See FBSBLK mask in RAT field 
buffer address 
See RBF field in RAB 
deleting 
fast 
See RBSFDL mask in ROP field 
See DELETE operation 
fast deletion 
See RBSFDL mask in ROP field 
format 
See RFM field in FAB 
locating 
See FIND operation 
longest . 
See LRL field in FAB 
reading 
See GET operation 
replacing 
See UPDATE operation 
size 
See RSZ field in RAB 
update existing 
See RBSUIF mask in ROP field 
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writing 
See PUT operation 
Record access block 
See RAB field in RAB 
Record access mode, 4-4 
Record context, 4-3 
Record file address 
See RFA field in RAB 
Record length 
longest 
See LRL field in FAB 
maximum 
See MRL field in FAB 
Record number 
maximum 
See MRN field in FAB 
Record operation, 4-9 
Record operation macro 
SDELETE, 5-25 
SFIND, 5-49, 5-51, 5-54 
SGET, 5-60, 5-63, 5-67 
SPUT, 5-91, 5-95 
STRUNCATE, 5-122 
SUPDATE, 5-124 
declaring, C-3 
Record processing, 4-3 
Record stream, 4-3 
Record-oriented device 
See FBSREC mask in DEV field 
Record-output characteristic 
See RAT field in FAB 
REF field in KEY block, 2-14 
CLOSE operation, 5-3 
CREATE operation, 5-9, 5-18 
DISPLAY operation, 5-30 
ENTER operation, 5-35 
ERASE operation, 5-40 
EXTEND operation, 5-46 
offset, 6-67 
OPEN operation, 5-73 to 5-74 
PARSE operation, 5-86 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-90 
REL argument to ORGS macro, 2-3 
Relative file 
declaring with ORGS macro, 2- 
Relative file organization 
See FBSREL code 
Relative record number 
See BKT field in RAB 
Remote operation 
P/OS, D-3 
REMOVE operation, 3-6 
SREMOVE macro, 5-102 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
_IFAB requirement, 2-5 
wildcard loop, 3-10 to 3-1l 
nonselective, 3-11 
selective, 3-12 
RENAME operation, 3-6 
SRENAME macro, 5-108 
BDB requirement, 2-8 
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I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-10 to 3-11 
nonselective, 3-11 
selective, 3-12 
Resultant string 
See RSA field in NAM block 
Retrieval pointer count 
See RTV field in FAB 
Return 
operation, from, 2-15 
Return from completion handler, 
2-20 
Revision date 
See RDT field in DAT block 
Revision number 
See RVN field in DAT block 
REWIND operation 
SREWIND macro, 5-114 
record stream, 4-9 
RFA field in RAB, 4-6 
CONNECT operation, 5-7 
FIND operation, 5-50, 5-52, 
5-54 
GET operation, 5-61, 5-65, 
5-67 
offset, 6-115 
PUT operation, 5-93, 5-96 
READ operation, 5-99, 5-101 
summary, 6-129 
WRITE operation, 5-128, 5-130 
RFA record access 
See RBSRFA code in RAC field 
RFM field in FAB 
CREATE operation, 5-11 
offset, 6-23 
OPEN operation, 5-78 
summary, 6-61 
RHB field in RAB, 4-7 
GET operation, 5-61, 5-64, 
5-68 
offset, 6-115 
PUT operation, 5-92, 5-96 
summary, 6-130 
UPDATE operation, 5-124 
RMSMAC.MLB macro library,. 2-22 
RSTS/E, D-3 
3 ROP field in RAB, 4-1, 
4-4 to 4-7 
CONNECT operation, 5-6 to 5-7 
DELETE operation, 5-25 
DISCONNECT operation, 5-27 
FIND operation, 5-49, 
5-51 to 5-52, 5-54 
FLUSH operation, 5-56 
FREE operation, 5-58 
GET operation, 5-60 to 5-61, 
5-63 to 5-64, 5-67 to 5-68 
NXTVOL operation, 5-70 
offset, 6-115 
PUT operation, 5-91 to 5-92, 
5-95 to 5-96 
READ operation, 5-98, 5-100 
REWIND operation, 5-114 
SPACE operation, 5-120 
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summary 
RBSASY mask, 6-131 
RBSEOF mask, 6-132 
RBSFDL mask, 6-133 
RBSKGE mask, 6-134 
RBSKGT mask, 6-135 
RBSLOA mask, 6-136 
RBSLOC mask, 6-137 
RBSMAS mask, 6-138 
RBSUIF mask, 6-139 
TRUNCATE operation, 5-122 
UPDATE operation, 5-124 
WRITE operation, 5-127, 5-129 
RRN 
See BKT field in RAB 
RSA field in NAM block, 3-10 
offset, 6-94 
SEARCH operation, 5-116 
summary, 6-103 
RSL field in NAM block 
CREATE operation, 5-21 
ENTER operation, 5-38 
ERASE operation, 5-43 
offset, 6-94 
OPEN operation, 5-81 
PARSE operation, 5-87 
REMOVE operation, 5-105 
RENAME operation, 5-112 
SEARCH operation, 
5-116 to 5-117 
summary, 6-104 
RSS field in NAM block 
offset, 6-94 
SEARCH operation, 5-116 
summary, 6-105 
RSTS/E RMS-11 
contrasted with PRO/RMS-1l, 
D-1 
contrasted with RSX-11 RMS-1l1, 
D-3 
RSX-11M/M-PLUS RMS-11 
contrasted with PRO/RMS-11, 
D-3 
contrasted with RSTS/E RMS-1i1, 
D-3 
RSZ field in RAB, 4-7, 4-13 
GET operation, 5-61, 5-65, 
5-68 
offset, 6-115 
PUT operation, 5-92, 5-95 
READ operation, 5-99, 5-101 
summary, 6-140 
UPDATE operation, 5-124 
WRITE operation, 5-127, 5-129 
RTV field in FAB 
CREATE operation, 5+13 
offset, 6-23 
OPEN operation, 5-75 
RSTS/E, D-3 
summary, 6-62 
RVB field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
summary, 6-91 
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RVN field in DAT block 
DISPLAY operation, 5-32 
offset, 6-14 
OPEN operation, 5-81 
RSTS/E, D=4 
summary, 6-21 

RVN field in NAM block 
RSX-ll, D-4 


SEARCH operation 
SSEARCH macro, 5-116 
BDB requirement, 2-8 
I/O buffer requirement, 2-7 
IFAB requirement, 2-5 
wildcard loop, 3-10 
explicit, 3-12 
implicit, 3-10 to 3-11 
SEQ argument to ORGS macro, 2-3 
Sequential block access 
See BKT field in RAB 
Sequential device 
See FBSSQD mask in DEV field 
Sequential file 
declaring with ORGS macro, 2-3 
Sequential file organization 
See FBSSEQ code 
Sequential record access 
See RBSSEQ code in RAC field 
Shared access 
See SHR field in FAB 
SHR field in FAB 
CREATE operation, 5-14 
offset, 6-22 
OPEN operation, 5-75 
READ operation, 5-99, 5-101 
summary, 6-63 
WRITE operation, 5-127, 5-129 
Single-directory device 
See FBSSDI mask in DEV field 
SIZ field in KEY block 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-80 
summary, 6-92 
S1Z0 field in KEY block 
offset, 6-68 
SIZ1 field in KEY block 
offset, 6-68 
SIZ2 field in KEY block 
offset, 6-68 
SI1Z3 field in KEY block 
offset, 6-68 
SIZ4 field in KEY block 
offset, 6-68 
S1Z5 field in KEY block 
offset, 6-68 
SI1Z6 field in KEY block 
offset, 6-68 
S1Z7 field in KEY block 
offset, 6-68 
SPACE operation, 4-14 
SSPACE macro, 5-120 
Stream, 4-2 
connecting 
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See CONNECT operation 
disconnecting 

See DISCONNECT operation 
internal identifier 

See ISI field in RAB 
unlocking bucket 

See FREE operation 
writing buffers 

See FLUSH operation 


Stream context 


advancing to next volume 
See NXTVOL operation 
rewinding 
See REWIND operation 


Stream operation 


block stream, 4-13 
record stream, 4-8 


Stream operation macro 


SCONNECT, 5-6 
SDISCONNECT, 5-27 
SFLUSH, 5-56 
SFREE, 5-58 
SNXTVOL, 5-70 
SREWIND, 5-114 
SWAIT, 5-126 
declaring, C-3 


Stream record format 


See FBSSTM code in RFM field 


String key 


See XBSSTG mask in DTP field 


STS field in FAB, 2-15, 3-5 


CLOSE operation, 5-4 
CREATE operation, 5-21 
DISPLAY operation, 5-32 
ENTER operation, 5-38 
ERASE operation, 5-43 
EXTEND operation, 5-47 
offset, 6-22 

OPEN operation, 5-82 
PARSE operation, 5-89 
REMOVE operation, 5-105 
RENAME operation, 5-112 
SEARCH operation, 5-118 
summary, 6-64 


STS field in RAB, 2-15, 4-2 


CONNECT operation, 5-8 

DELETE operation, 5-26 

DISCONNECT operation, 5-27 

FIND operation, 5-50, 5-53, 
5-55 

FLUSH operation, 5-56 

FREE operation, 5-58 

GET operation, 5-62, 5-65, 
5-68 

NXTVOL operation, 5-70 

offset, 6-115 

PUT operation, 5-93, 5-97 

READ operation, 5-99, 5-101 

REWIND operation, 5-115 

SPACE operation, 5-120 

summary, 6-141 

TRUNCATE operation, 5-122 

UPDATE operation, 5-125 

WRITE operation, 5-128, 5-130 


STV field in FAB, 2-15, 3-5 
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CLOSE operation, 5-4 
CREATE operation, 5-21 
DISPLAY operation, 5-32 
ENTER operation, 5-38 
ERASE operation, 5-43 
EXTEND operation, 5-47 
offset, 6-22 
OPEN operation, 5-82 
PARSE operation, 5-89 
REMOVE operation, 5-105 
RENAME operation, 5-112 
SEARCH operation, 5-118 
summary, 6-65 
STV field in RAB, 2-15, 4-2 
CONNECT operation, 5-8 
DELETE operation, 5-26 
DISCONNECT operation, 5-27 
FIND operation, 5-50, 5-53, 
5-55 
FLUSH operation, 5-56 
FREE operation, 5-58 
GET operation, 5-62, 5-65, 
5-68 
NXTVOL operation, 5-70 
offset, 6-115 
PUT operation, 5-93, 5-97 
READ operation, 5-99, 5-101 
REWIND operation, 5-115 
SPACE operation, 5-120 
summary, 6-142 
TRUNCATE operation, 5-122 
UPDATE operation, 5-125 
WRITE operation, 5-128, 5-130 
SUS-~family symbol 
declaring, C-3 
value, A-1l 
Success 
handler, 2-18 
SUM block 
chaining to FAB, 2-13 
declaring, 2-9 
initializing, 2-10 
summary, 6-145 
Summary XAB 
See SUM block 
Supersession 
See FBSSUP mask in FOP field 
Symbol-declaration macro, 2-2 
SYN argument to RABSB macro, 2-8 
RSTS/E, D-4 ; 
Synchronous operation 
See RBSASY mask in ROP field 


Temporary file 
See FBSTMP mask in FOP field 
Terminal device, 3-1, 5-20, 
5-37, 5-42, 5-77, 5-88, 
5-104, 5-111, 5-117 
See FBSTRM mask in DEV field 
TKS field in KEY block 
DISPLAY operation, 5-31 
offset, 6-68 
OPEN operation, 5-81 
summary, 6-93 
TRUNCATE operation, 4-11 
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STRUNCATE macro, 5-122 


UBF field in RAB, 4-7, 4-13 
CONNECT operation, 5-6 
GET operation, 5-61, 5-64, 
5-67 
offset, 6-115 
PUT operation, 5-92, 5-96 
READ operation, 5-98, 5-100 
summary, 6-143 
Undefined record format 
See FBSUDF code in RFM field 
Unit-record device, 3-2, 5-20, 
5-37, 5-43, 5-77, 5-88, 
5-104, 5-111, 5-117 
UPD argument to ORGS macro, 2-3 
UPDATE operation, 4-11 
SUPDATE macro, 5-124 
declaring with ORGS macro, 2-3 
User buffer 
address 
See UBF field in RAB 
size ; 
See USZ field in RAB 
USZ field in RAB, 4-7, 4-13 
CONNECT operation, 5-6 
GET operation, 5-61, 5-64, 
5-67 
offset, 6-115 
PUT operation, 5-92, 5-96 
READ operation, 5-98, 5-100 
summary, 6-144 


Variable-length record format 

See FBSVAR code in RFM field 
VBN 

See BKT field in RAB 
VBN access 

See BRKT field in RAB 
VFC carriage control 

See FBSPRN mask in RAT field 
VFC header buffer address 

See RHB field in RAB 
VFC record format 

See FBSVFC code in RFM field 
Virtual block number 

See BKT field in RAB 
Volume 

advancing to next 

See NXTVOL operation 


WAIT operation 
SWAIT macro, 5-126 
block stream, 4-14 
record stream, 4-9 
wec field in NAM block 
offset, 6-94 
PARSE operation, 5-87 
SEARCH operation, 5-116, 5-118 
summary, 6-106 
WDI field in NAM block 
offset, 6-94 
PARSE operation, 5-87 
SEARCH operation, 5-116, 5-118 
summary, 6-107 


Wildcard 
directory context 
See WDI field in NAM block 
file context 
See wcc field in NAM block 
operation 
See NBSWCH mask in FNB field 
Wildcard loop, 3-9 
Writable-block context, 4-12 
WRITE operation, 4-14 
SWRITE macro 
sequential access, 5-127 
VBN access, 5-129 


X$-family macro, 2-10 
declaring 
ALL block, C-3 
DAT block, C-3 
KEY block, C-3 
PRO block, C-3 
SUM block, C-3 
XAB 
chaining to FAB, 2-13 
See also ALL block 
See also DAT block 
See also KEY block 
See also PRO block 
See also SUM block 
XAB field in FAB 
chaining XABs to FAB, 2-13 
CLOSE operation, 5-3 
CREATE operation, 5-9 
DISPLAY operation, 5-29 
ENTER operation, 5-35 
ERASE operation, 5~40 
EXTEND operation, 5-46 
offset, 6-24 
OPEN operation, 5-73 
PARSE operation, 5-86 
REMOVE operation, 5-102 
RENAME operation, 5-108 
SEARCH operation, 5-116 
summary, 6-66 
XABSB macro, 2-8 to 2-9, C-3 
XABSBT macro, C-4 
XABSE macro, 2-10 
declaring, C-3 
XABOFS macro, C-4 
XBS-family symbol 


declaring 
ALL block, C-3 to C4 
DAT block, C-3 to C-4 
KEY block, C-3 to C-4 
PRO block, C-3 to C-4 
SUM block, C-3 to C-4 
XAB, C-4 


XBSALL code in COD field, 2-8 
summary, 6-10 
value, 6-2 

XBSBN2 code in DTP field 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSBN4 code in DTP field 
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CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSCHG mask in FLG field 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
summary, 6-76 
value, 6-67 

XBSCTG mask in AOP field 
CREATE operation, 5-18 
EXTEND operation, 5-47 
OPEN operation, 5-79 
RSTS/E, D-4 
summary, 6-6 
value, 6-2 

XBSCYL mask in ALN field 
RSTS/E, D-3 to D-4 


XBSDAT code in COD field, 2-8 


summary, 6-17 
value, 6-14 

XBSDTL code in BLN field 
summary, 6-15 
value, 6-14 

XBSDUP mask in FLG field 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
summary, 6-77 
value, 6-67 

XBSHRD mask in AOP field 
CREATE operation, 5-17 
EXTEND operation, 5-47 
of ALL block 

RSX-11, D-4 

OPEN operation, 5-79 
RSTS/E, D-4 
Summary, 6-7 
value, 6-2 

XBSIN2 code in DTP field 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSIN4 code in DTP field 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSINI mask in FLG field 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 

XBSKEY code in COD field, 
summary, 6-70 
value, 6-67 

XBSKYL code in BLN field 
summary, 6-69 
value, 6-67 

XBSLAL code in BLN field 
summary, 6-9 
value, 6-2 

XBSLBN mask in ALN field 
CREATE operation, 5-17 
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EXTEND operation, 5-47 
RSTS/E, D-3 to D-4 
value, 6-2 
XBSNUL mask in FLG field 
CREATE operation, 5-19 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
summary, 6-78 
value, 6-67 
XBSPAC code in DTP field 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 
XBSPRL code in BLN field 
summary, 6-109 
value, 6-108 
XBSPRO code in COD field, 2-9 
summary, 6-110 
value, 6-108 
XBSSML code in BLN field 
summary, 6-146 
value, 6-145 
XBSSTG code in DTP field 
CREATE operation, 5-18 
DISPLAY operation, 5-31 
OPEN operation, 5-80 
value, 6-67 
XBSSUM code in COD field, 2-9 
summary, 6-147 
value, 6-145 
XBSVBN mask in ALN field 
CREATE operation, 5-17 
EXTEND operation, 5-47 
RSTS/E, D-3 to D-4 
value, 6-2 
XBAOFS$ macro, C-4 
XBDOFS$ macro, C-4 
XBKOFS macro, C-4 
XBPOFS macro, C-4 
XBSOFS macro, C-4 
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READER’S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 


Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the page number. 


Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 

Other (please specify) 
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